Vault Terminal · Reference
Command reference
All commands operate on the current project's local `.contextvault/` directory. Run `contextvault help` for the compact terminal overview.
contextvault initInitialize the project vault and create missing local storage folders.
contextvault recordStart the interactive recorder for raw work notes, decisions, and follow-ups.
contextvault listList saved sessions with IDs, dates, sources, titles, and event counts.
contextvault show latestPrint the latest session; pass a session ID in place of latest to inspect another.
contextvault exportWrite a combined Markdown export of memory, recent sessions, decisions, tasks, and problems.
contextvault search "redirect loop"Find literal text in saved session Markdown.
contextvault import ./browser-export.zipImport a Markdown export, ZIP archive, or directory of browser exports.
contextvault indexRebuild the unified local context index from project sessions and imports.
contextvault retrieve "auth middleware"Rank relevant project evidence for a topic or task.
contextvault prepare "auth middleware"Generate an agent-ready context handoff under .contextvault/exports.
contextvault memoryUpdate generated project memory from decisions, tasks, and problems.
contextvault link <from-id> <to-id> "related"Record an explicit relationship between two sessions.
contextvault timelineGenerate a chronological Markdown timeline from indexed project events.
contextvault history --since 14dReview recent project activity and filter it with query/source/type options.
contextvault tasks --since 2wList captured follow-up tasks.
contextvault decisions auth --source codexSearch decisions by query and source.
contextvault problems redis --since 30dSearch problems and failed attempts by query and date.
Shared query filters
--type decision,problem
--source codex
--since 24h / 14d / 2w
--limit 10
A useful retrieval example
contextvault retrieve "payment webhook retry" --type decision,problem --source codex --since 30d --limit 10Retrieval uses local phrase/token matching, event-type weighting, and recency. It does not run embeddings or semantic model calls.