vaults

# case.dev Vaults Encrypted document storage with automatic OCR, chunking, and semantic search. Each vault is an isolated container for a case, project, or document collection. Requires the `casedev` CLI. See `setup` skill for installation and auth. ## Create a Vault ```bash casedev vault create --name "Smith v Jones Discovery" --description "Phase 1 documents" --json ``` Flags: - `--name` / `-n` (required) - `--description` / `-d` - `--disable-graph` — skip knowledge graph construction - `--disable-indexing` — skip automatic ingestion (upload-only mode) ## List Vaults ```bash casedev vault list --json casedev vault list --wide --json # includes description column ``` ## Get Vault Details ```bash casedev vault get VAULT_ID --json ``` Also accepts focused vault if set via `casedev focus set --vault VAULT_ID`. ## Upload Files ### Single file ```bash casedev vault object upload ./contract.pdf --vault VAULT_ID --json ``` Flags: `--name` (override filename), `--content-type`, `--no-ingest` (skip indexing). ### Directory (recursive) ```bash casedev vault upload ./discovery-docs/ --vault VAULT_ID --json ``` Preserves folder structure. Each file gets a presigned URL upload with confirmation. Use `--no-ingest` to upload without triggering indexing. Use `--content-type` to force a MIME type for all files. ## List Objects in a Vault ```bash casedev vault object list --vault VAULT_ID --json ``` Returns: object ID, filename, ingestion status, size. ## Download Files ```bash # Download a single object casedev vault download --vault VAULT_ID --object OBJECT_ID --out ./output/ --json # Download all objects casedev vault download --vault VAULT_ID --out ./all-docs/ --json # Download by path prefix casedev vault download --vault VAULT_ID --path "exhibits/" --out ./exhibits/ --json ``` ## Semantic Search ```bash casedev search vault "force majeure clause" --vault VAULT_ID --json ``` Search methods: - `--method hybrid` (default) — combines vector + keyword search - `--method fast` — keyword-only, faster - `--method global` — cross-vault if supported Additional flags: - `--limit` / `-l` — max results (default 10) - `--object OBJECT_ID` — restrict search to specific object(s), repeatable Returns: answer summary, source documents, matching chunks with page ranges and scores. If hybrid mode returns a server error, retry with `--method fast`. ## Common Workflows ### Upload and search a case file set ```bash # 1. Create vault casedev vault create --name "Acme v Beta" --json # 2. Upload documents casedev vault upload ./case-files/ --vault VAULT_ID --json # 3. Wait for ingestion (check object status) casedev vault object list --vault VAULT_ID --json # 4. Search casedev search vault "indemnification obligations" --vault VAULT_ID --json ``` ### Focus workflow (skip --vault on every command) ```bash casedev focus set --vault VAULT_ID casedev vault object list --json casedev search vault "damages calculation" --json casedev vault download --object OBJ_ID --out ./downloads/ --json ``` ## Troubleshooting **"Missing vault ID"**: Provide `--vault VAULT_ID` or set focus with `casedev focus set --vault VAULT_ID`. **Upload fails with HTTP 4xx**: Check file size (max 500MB per object), verify vault ID exists, confirm auth. **Search returns no results**: Ensure objects have completed ingestion (status: "completed" in object list). Try `--method fast` if hybrid fails.