Claude Code Log CLI
A Python CLI that turns Claude Code JSONL transcripts into readable HTML and Markdown with search, filters and a timeline.
- 1,259 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The finished pages hold the whole dialogue with the agent, which may contain secrets and internal paths.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/claude-code-logDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The finished pages hold the whole dialogue with the agent, which may contain secrets and internal paths.
This is third-party code. Review the repository files before installing.
What it does
Claude Code Log reads transcript files from `~/.claude/projects/` and builds pages from them: from a top index with project cards to a separate page per session. The conversation is shown in order: user prompts, assistant replies, tool calls, thinking and images. Token usage is visible per message and session. There is an interactive terminal interface for browsing sessions and exporting, a `watch` mode that rebuilds files as a session is written, and a `serve` command with full-text search over the whole archive on a local address. Pages filter by message type and by a date range in plain language (yesterday, last week) and appear on an interactive timeline. The `minimal` theme folds sub-agent branches and rewinds into collapsible blocks. Commit hashes in text become links to GitHub, GitLab and Bitbucket, and a `--git-link` template covers your own servers. Codex CLI and Antigravity CLI are supported for experimental single-session export. Quick run with no install: `uvx claude-code-log@latest --open-browser`.
Who it is for. Developers who want to read, search and revisit their Claude Code sessions as a document rather than raw JSONL.
Good fit when
- Finding which session had the agent change a particular file or discuss a decision.
- You want to share a review of the agent's work with a colleague as HTML or Markdown.
- Checking token usage by session and message.
- You want notes in Obsidian or an editor that update as a session runs.
- Reviewing sub-agent branches and rewinds without scrolling a raw log.
Not a fit when
- You need real-time session monitoring with alerts, whereas the tool rebuilds files but does not watch work quality.
- Transcripts contain secrets and you plan to publish pages beyond the team: check them before sharing.
- You use a different agent, since Claude Code is the main format and the rest are experimental.
Example request
Build an HTML archive of all my Claude Code sessions from last week and open it in the browser with search.Limitations
The tool works with local files and sends nothing out, but the finished pages hold the whole dialogue text, including any secrets and paths. Project pages can run to several megabytes. Codex CLI and Antigravity CLI support is experimental, single-session export only through `--provider` and `--session-id`. The Claude Code transcript format is not fixed, so changes to it may break the tool until an update ships. Installing needs Python and ideally uv.
How to disable. Run `uv tool uninstall claude-code-log`. Generated HTML and Markdown files sit next to the transcripts in `~/.claude/projects/`, so delete them by hand.
FAQ
Where does the data come from?
From Claude Code JSONL transcripts in `~/.claude/projects/`. The tool reads them locally.
How do I search across all sessions?
Run `claude-code-log serve`, which serves the archive on a local address with full-text search.
Can I get Markdown?
Yes, with the `--format md` flag or an export from the terminal interface. `watch` mode updates files as a session runs.
Are other agents supported?
Experimentally: Codex CLI and Antigravity CLI for one session via `--provider codex` or `agy`.
How do I filter by date?
The flags accept plain language such as `today`, `yesterday` or `last week`.
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
claude-history searches and opens past Claude Code, Codex and Pi conversations in the terminal and gives Claude a history skill
Claude Vault turns Claude chat exports and Claude Code history into Markdown notes for an Obsidian vault, with search.
cc-lens
Claude Code Lens (cc-lens)
Local Claude Code analytics: a dashboard of sessions, tokens, cost and projects from your ~/.claude data, no cloud
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
A local dashboard over the .claude folder shows where Claude Code context goes and draws the chain of subagent calls over time.
README in short
The author describes the tool as a Python CLI that turns Claude Code transcripts into clean pages with a chronological prompt and reply view. There is an example output and a feature walkthrough in chapters.