ContextVaultDocs
Documentation/Vault Terminal/Command reference
← All guides

Vault Terminal

Command reference

A concise reference for every published Vault Terminal command and its common filters.

Vault Terminal · Reference

Command reference

All commands operate on the current project's local `.contextvault/` directory. Run `contextvault help` for the compact terminal overview.

CommandUse it to
contextvault init

Initialize the project vault and create missing local storage folders.

contextvault record

Start the interactive recorder for raw work notes, decisions, and follow-ups.

contextvault list

List saved sessions with IDs, dates, sources, titles, and event counts.

contextvault show latest

Print the latest session; pass a session ID in place of latest to inspect another.

contextvault export

Write 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.zip

Import a Markdown export, ZIP archive, or directory of browser exports.

contextvault index

Rebuild 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 memory

Update generated project memory from decisions, tasks, and problems.

contextvault link <from-id> <to-id> "related"

Record an explicit relationship between two sessions.

contextvault timeline

Generate a chronological Markdown timeline from indexed project events.

contextvault history --since 14d

Review recent project activity and filter it with query/source/type options.

contextvault tasks --since 2w

List captured follow-up tasks.

contextvault decisions auth --source codex

Search decisions by query and source.

contextvault problems redis --since 30d

Search problems and failed attempts by query and date.

Shared query filters

--type decision,problem

Filter by event types: user, agent, note, decision, task, problem.

--source codex

Filter by source, such as codex, claude-code, cursor, terminal, browser, or manual.

--since 24h / 14d / 2w

Limit results by relative age or provide a fixed ISO date.

--limit 10

Cap the number of ranked results returned.

A useful retrieval example

bash
contextvault retrieve "payment webhook retry" --type decision,problem --source codex --since 30d --limit 10

Retrieval uses local phrase/token matching, event-type weighting, and recency. It does not run embeddings or semantic model calls.