vaults

name	vaults
description	Manages case.dev encrypted document vaults for legal workflows. Creates vaults, uploads files and directories, lists and downloads objects, and runs semantic search across vault contents. Use when the user mentions "vault", "upload documents", "document storage", "download files", "vault search", or needs to manage case files and discovery documents.

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.