Claude Vault CLI
Claude Vault turns Claude chat exports and Claude Code history into Markdown notes for an Obsidian vault, with search.
- 86 ★ on the repository
- Last commit
Extended access
Why this level
- The tool reads whole conversation history that may contain passwords and personal data.
- It writes Markdown files into your vault and can watch directories.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/claude-vaultDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The tool reads whole conversation history that may contain passwords and personal data.
- It writes Markdown files into your vault and can watch directories.
This is third-party code. Review the repository files before installing.
What it does
Claude Vault reads the `conversations.json` export from claude.ai, Claude Code history from `~/.claude` and OpenCode sessions from a `.db` file. The format is detected automatically and every conversation is written to the `conversations/` folder as a Markdown file. A local model through Ollama can add tags and write summaries, and without it the tool falls back to keyword extraction. Search works by meaning (it needs the `nomic-embed-text` model) and by words. Files can be renamed and moved because the link is stored by UUID. The `watch` mode syncs the vault when exports change, and `--dry-run` shows edits before writing.
Who it is for. People who keep a knowledge base in Obsidian and want to find past Claude and agent conversations among their notes.
Good fit when
- You need to find a month-old conversation about async error handling.
- Claude Code history piles up in `~/.claude` and reads better as Obsidian notes.
- Agent conversations contain personal data that must be masked before saving.
- Chat exports keep updating and the vault should pick up new conversations automatically.
Not a fit when
- You have no Obsidian vault and no use for Markdown files.
- You want cloud search across chats: the tool works only locally.
- The environment cannot install Python 3.9 or newer.
Example request
Sync my Claude Code history from `~/.claude` into my Obsidian vault with `--dry-run` and show which conversations would be written.Limitations
Python 3.9 or newer is required. Tags, summaries and semantic search need Ollama installed with the `llama3.2:3b` and `nomic-embed-text` models, and without them only keywords work. The claude.ai export must be made by hand under Settings, Export data. The tool reads whole conversation history, which may hold passwords and personal data: use the `--detect-pii` flag with `--redact-pii` or `--skip-sensitive`. The repository declares no license, so ask the author about terms of use.
How to disable. Stop the watcher with `claude-vault watch-stop` and uninstall the package. Clean the `conversations/` folder in the vault by hand.
FAQ
How do I install Claude Vault?
Run `pip install -e .` in the cloned repository, then `claude-vault init` inside the Obsidian folder and `claude-vault sync ~/Downloads/conversations.json`.
How do I import Claude Code history?
Point the tool at the history folder: `claude-vault sync ~/.claude`. The format is detected automatically.
How do I find a conversation by meaning?
Use `claude-vault search "async error handling"`. Semantic search needs Ollama and the `nomic-embed-text` model, and keyword search is enabled with `--mode keyword`.
How do I hide personal data?
Add `--detect-pii --redact-pii` to `sync`: stored files then contain markers such as `[REDACTED-EMAIL]`. The `--skip-sensitive` flag skips such conversations entirely.
Does it need the internet?
No, the tool is local. It needs no external APIs, and Ollama runs on your machine.
Discussion
No questions or reviews yet.
Related
CLI toolsClaude Conversation Extractor: export Claude Code chats
Claude Conversation Extractor
A zero-dependency Python CLI that finds Claude Code logs in ~/.claude/projects, searches them and saves chats as Markdown, JSON or HTML
A Python CLI that turns Claude Code JSONL transcripts into readable HTML and Markdown with search, filters and a timeline.
claude-history searches and opens past Claude Code, Codex and Pi conversations in the terminal and gives Claude a history skill
An Obsidian vault template for Claude Code: /daily, /weekly, /monthly and /project commands link three-year goals to today's tasks
A plugin and skill set that turns an Obsidian vault into a knowledge base with sources, links and grounded answers
Claude Code History Viewer
claude-code-history-viewer
A desktop app for browsing, searching and analyzing conversation history from Claude Code, Codex CLI, Gemini CLI, Cursor, Cline, Aider and other agents
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Claude Vault (this card) | no | 86 | |
| claude-obsidian | no | 16,358 | a plugin linking Claude and Obsidian; Claude Vault imports exports and history into notes |
| SwarmVault | yes | 735 | another CLI for knowledge vaults; Claude Vault focuses on conversation history with Claude and agents |
README in short
Two-way sync by UUID, a watch mode for exports and a dry run with no writes. Three import formats are detected from the file.