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

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

casedev vault list --json
casedev vault list --wide --json   # includes description column

Get Vault Details

casedev vault get VAULT_ID --json

Also accepts focused vault if set via casedev focus set --vault VAULT_ID.

Upload Files

Single file

casedev vault object upload ./contract.pdf --vault VAULT_ID --json

Flags: --name (override filename), --content-type, --no-ingest (skip indexing).

Directory (recursive)

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

casedev vault object list --vault VAULT_ID --json

Returns: object ID, filename, ingestion status, size.

Download Files

# 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

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

# 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)

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.

vaults