Command line¶
| Command | |
|---|---|
chronicle install [--yes] [--dry-run] |
Setup: lists the agents found, asks which to record, imports them, starts the dashboard (Install) |
chronicle app |
The desktop app (window + menu bar); needs the app extra |
chronicle ui [--open] |
Dashboard (also always running at :8765 after install; if it is, chronicle ui says so and --open opens it). Sessions, Knowledge, Projects and Glossary switch between Cards and List (a sortable table; click a row for details), remembered per page |
chronicle sessions [-p project] [--since 7d] |
List sessions |
chronicle show <id-prefix> [--transcript\|--markdown\|--json] |
Session overview or full conversation |
chronicle search <words> |
Full-text search over transcripts + knowledge (any language, 3+ chars) |
chronicle knowledge [query] [-k gotcha] [-p project] |
Browse extracted knowledge |
chronicle projects / chronicle stats [--since 30d] |
Per-project and overall statistics |
chronicle analyze <id> \| --pending [--limit N] [--dry-run] [--backend codex] |
Analyze now (--dry-run shows digest sizes, no tokens spent; --backend picks the agent for this run only) |
chronicle synthesize [--project P] [--global] [--all] |
Rebuild knowledge bases |
chronicle export [--full] |
Rewrite the Markdown vault |
chronicle export <id>… [--format md\|json\|raw] [--out PATH] |
Export sessions: one file, or a .zip of several (raw: the original transcript) |
chronicle glossary [term] [-p project] [--rebuild --all] [--themes] |
Your vocabulary: internal names, acronyms, domain terms with definitions and usage; --themes groups big categories into themes for the Map |
chronicle review [2026-W39\|current] |
Weekly engineering review written by the analysis model (automatic for each completed week) |
chronicle import <zip> [--analyze] |
Import chats from a claude.ai or ChatGPT data export (the .zip, its folder, or conversations.json); repeatable. See Sources |
chronicle forget <id> [--delete-transcript] |
Remove a session from the vault for good (it is never re-ingested) |
chronicle sources |
Which agents are connected, and how |
chronicle connect <agent> / disconnect <agent> |
Start/stop recording claude, codex, codex-cloud, copilot or bob (data is kept) |
chronicle connect <client> / disconnect <client> |
Add or remove the MCP server in claude-desktop, cursor, windsurf or gemini |
chronicle mcp [--print-config] |
Run the MCP server (clients start it), or print a config entry for any other MCP client |
chronicle status |
Health: hooks, agents, MCP, queue, failures |
chronicle config [edit] |
Show or edit ~/.claude-chronicle/config.toml |
chronicle config set <section.key> <value> |
Change one setting, e.g. chronicle config set analysis.backend codex (Configuration) |
Other ways in¶
Markdown vault: ~/.claude-chronicle/notes (open it as an Obsidian vault): Home.md,
Sessions/YYYY/MM/*.md with YAML frontmatter, Projects/*.md (knowledge base + session list),
Knowledge/<Kind>.md, Reviews/YYYY-Www.md, Glossary.md, Global Playbook.md.
Inside your agents (MCP tools, registered in Claude Code and in each connected agent): search_knowledge, search_sessions, get_session,
get_transcript, project_knowledge, glossary, recent_sessions. Ask e.g. "have we hit this error before?"
or "what is the deployer_ip rule?".
The MCP server is registered when you connect an agent (see Sources). MCP server covers each tool and how to connect other clients.