ox import
Import documents or video URLs into team context for onboarding and knowledge sharing. File imports are stored with LFS-backed content. URL imports submit videos for cloud processing (transcription, summarization).
Usage
ox import <file|url> [flags]Examples
Import a document
# Import a PDF
ox import report.pdf
# Import with pre-extracted text for better indexing
ox import report.pdf --text extracted.md
# Import with a specific date
ox import notes.md --date 2026-01-15
# Import to a specific team
ox import design-doc.md --team acme-designImport a video URL
# Import a Loom video
ox import https://www.loom.com/share/abc123 --title "Architecture Review"
# Import a Cap recording
ox import https://cap.link/abc123 --title "Sprint Retro"
# Import a direct video URL
ox import https://example.com/meeting.mp4 --title "Team Standup"Check import status
# List all imports
ox import --list
# Check processing status
ox import --status rec_01234567
# Watch until processing completes
ox import --status rec_01234567 --watchFlags
| Flag | Description |
|---|---|
--text <file> | Path to pre-extracted text/markdown for indexing |
--date <YYYY-MM-DD> | Date for filing (default: auto-detect from metadata) |
--title <text> | Display title for URL imports |
--team <id> | Team ID or slug (default: auto-discovered from repo) |
--force | Re-import even if content hash already exists |
--status <id> | Check processing status of a URL import |
--watch | Poll --status until processing completes or fails |
--list | List imports and their processing status |
Supported file types
| Type | Extensions |
|---|---|
| Documents | .pdf, .docx, .md, .txt, .html |
| Data | .json, .yaml, .csv |
| Images | .png, .jpg, .jpeg |
| Audio | .m4a, .mp3, .wav, .ogg, .opus, .flac |
| Video | .mp4, .mov, .mkv, .avi |
Supported video platforms
- Loom —
https://www.loom.com/share/... - Cap —
https://cap.link/... - Direct URLs — Any accessible
.mp4,.webm, etc.
How file imports work
- Upload — Content is uploaded to LFS (Git Large File Storage)
- Pointer — A small pointer file is committed to team context
- Metadata —
metadata.jsontracks title, content type, date, sidecars - Push — Changes are pushed to the team context repo
Files are stored at:
data/docs/YYYY/MM/DD/<slug>/
├── metadata.json # Document metadata
├── original.pdf # LFS pointer to original
└── extracted.md # LFS pointer to extracted text (if provided)How URL imports work
- Submit — URL is sent to SageOx cloud for processing
- Download — Cloud downloads the video
- Transcribe — Audio is transcribed
- Summarize — AI generates summary and key points
- Store — Results are stored in team context
Track progress with --status and --watch.
Deduplication
Imports are deduplicated by content hash. If you try to import a file that's already been imported, ox will skip it:
ox import report.pdf
# Already imported (id: architecture-review). Use --force to reimport.Use --force to reimport anyway.