@continuevault/cli

Save your Claude Code and Codex CLI sessions to your ContinueVault vault — automatically, in the background.

Your terminal AI work is saved the same way ContinueVault's browser extension saves your ChatGPT and Claude conversations. Search it, continue it across platforms, and never lose a session again.

Quick start

npm install -g @continuevault/cli
cv install

That's it. cv install handles everything: authenticates you, detects your Claude Code installation, creates the configuration, and starts the background service. Your sessions start syncing automatically.

You'll need a ContinueVault account (free tier available) and Node.js 20+.

How it works

The agent watches for new conversation data in:

• ~/.claude/projects/ — Claude Code JSONL transcripts
• Codex CLI conversation logs

When new content appears, it's filtered, queued locally, and synced to your vault in batches. If the server is temporarily unavailable, events queue up and sync when connectivity returns.

Sessions appear in your ContinueVault dashboard with "Claude Code" or "Codex" platform labels, alongside your browser-saved conversations.

Content filtering

Filtering happens on your machine before anything leaves it.

Conversation mode (default) — saves your messages and the AI's responses. Tool calls (tool_use and tool_result blocks) are replaced with redacted placeholders. Your dialogue is preserved; source code, file contents, and command outputs accessed by tools stay on your machine.

Full mode — saves everything, including all tool calls and their results: file contents, bash output, code execution results, and thinking blocks. Use this when the tool I/O is part of the work you want to preserve.

Configuration

Filter settings live in ~/.continuevault/config.toml:

[filter]
default = "conversation"

# Per-project overrides
[filter.projects]
"/home/user/open-source-project" = "full"
"/home/user/client-work" = "conversation"

Project paths are matched against the working directory in the JSONL transcript, so you can use full mode on open-source work while keeping proprietary projects conversation-only.

Commands

| Command | Description | | --- | --- | | cv install | Full setup: login, configure, install and start background service | | cv uninstall | Stop service, remove config and credentials. Does not touch ~/.claude or ~/.codex | | cv login | Authenticate via device code flow (opens browser) | | cv logout | Remove stored credentials from OS keychain | | cv codex | Wire ContinueVault MCP auth into your Codex CLI configuration | | cv start | Start the background agent | | cv stop | Stop the background agent | | cv status | Show agent state, auth, watched paths, queue depth, filter mode | | cv status --logs [n] | Show recent daemon log output (default 20 lines) | | cv config | View or update configuration | | cv queue | Inspect the sync queue | | cv queue --stuck | Show quarantined events (failed 3+ times) | | cv queue --retry | Reset quarantined events for another attempt | | cv queue --drop | Permanently discard quarantined events | | cv flush | Trigger immediate sync (bypass normal interval) | | cv start --foreground | Run in foreground instead of as a service (for debugging) |

Background service

The agent installs as a system service so it starts on login and runs automatically:

| Platform | Service type | | --- | --- | | Linux / WSL2 | systemd | | macOS | launchd | | Windows | Task Scheduler |

Authentication

cv login uses a device code flow: you get a URL and a code, open the URL in your browser, and sign in with your ContinueVault account. Credentials are stored in your OS keychain — not in a plain text config file. This is the same account you use for the ContinueVault browser extension and dashboard.

Troubleshooting

Agent isn't saving sessions:

1. Run cv status — check that the service is running and authenticated
2. Verify ~/.claude/projects/ exists and contains .jsonl files
3. If Claude Code has cleanupPeriodDays set to 0, it disables transcript persistence — remove that setting or set it to a positive number
4. Run cv queue to check for stuck events, cv queue --retry to retry them

Force an immediate sync:

cv flush

See what the daemon is doing:

cv status --logs 50

Backlog upload tuning:

The daemon uploads serially and adapts batch size from 50 up to 500 events when the server is healthy. Operators can lower the ceiling with CV_CLI_SYNC_MAX_BATCH_SIZE, tune the ramp with CV_CLI_SYNC_BATCH_STEP, or adjust CV_CLI_SYNC_TARGET_LATENCY_MS and CV_CLI_SYNC_SUCCESS_DELAY_MS for emergency backlog drains.

What is ContinueVault?

ContinueVault saves your AI conversations across Claude, ChatGPT, Gemini, Grok, DeepSeek, Perplexity, and Le Chat — makes them searchable from one dashboard, and lets you continue any conversation on any platform with your full context loaded.

The browser extension handles web-based AI tools. This CLI handles terminal-based AI tools. Together they give you complete coverage.

• Website
• Dashboard
• Quick Start Guide
• MCP Commands Guide
• Free vs Pro

License

Proprietary — see Terms of Service.