{"id":48525003,"url":"https://github.com/delexw/claude-code-trace","last_synced_at":"2026-04-07T22:03:56.608Z","repository":{"id":344062600,"uuid":"1178759952","full_name":"delexw/claude-code-trace","owner":"delexw","description":"Real-time Claude Code session log viewer and monitor. Tail, search, and visualize JSONL session files with a native desktop GUI, a web and a tui. Built with Tauri 2, React, and TypeScript.","archived":false,"fork":false,"pushed_at":"2026-04-02T21:57:58.000Z","size":15098,"stargazers_count":64,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-02T23:36:59.526Z","etag":null,"topics":["claude-code","desktop-gui","jsonl","monitor","react","search","session-log","tail","tauri-2","typescript","viewer","visualize"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/delexw.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-11T10:41:19.000Z","updated_at":"2026-04-02T22:33:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/delexw/claude-code-trace","commit_stats":null,"previous_names":["delexw/tail-claude-gui","delexw/claude-code-trace"],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/delexw/claude-code-trace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delexw%2Fclaude-code-trace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delexw%2Fclaude-code-trace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delexw%2Fclaude-code-trace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delexw%2Fclaude-code-trace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/delexw","download_url":"https://codeload.github.com/delexw/claude-code-trace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delexw%2Fclaude-code-trace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31530647,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-07T16:28:08.000Z","status":"ssl_error","status_checked_at":"2026-04-07T16:28:06.951Z","response_time":105,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","desktop-gui","jsonl","monitor","react","search","session-log","tail","tauri-2","typescript","viewer","visualize"],"created_at":"2026-04-07T22:02:48.002Z","updated_at":"2026-04-07T22:03:56.600Z","avatar_url":"https://github.com/delexw.png","language":"Rust","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"icon.png\" alt=\"claude-code-trace\" width=\"128\" /\u003e\n\u003c/p\u003e\n\n# Claude Code Trace\n\nA desktop + web viewer for Claude Code session JSONL files. Built with [Tauri v2](https://v2.tauri.app/) (Rust backend + React frontend).\n\nReads session logs from `~/.claude/` and renders them as a scrollable conversation with expandable tool calls, token counts, and live tailing. Works as a **native desktop app** (macOS, Linux, Windows) or as a **web app** in any browser.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"demo.gif\" alt=\"Demo\" /\u003e\n\u003c/p\u003e\n\n## Install\n\n### Build from source (any platform with Rust + Node.js)\n\n```bash\ngit clone git@github.com:delexw/claude-code-trace.git\ncd claude-code-trace\n./script/install.sh       # builds everything + installs to PATH\n\ncctrace              # desktop app (default)\ncctrace --web        # web mode (opens browser)\ncctrace --tui        # terminal UI\n```\n\n### Download pre-built\n\nGrab the latest release from [Releases](https://github.com/delexw/claude-code-trace/releases):\n\n| Platform | File                            |\n| -------- | ------------------------------- |\n| macOS    | `.dmg`                          |\n| Linux    | `.deb`, `.rpm`, `.AppImage`     |\n| Windows  | `.msi`, `.exe` (NSIS installer) |\n\n\u003e [!IMPORTANT]\n\u003e **macOS:** The app is unsigned. After installing, remove the quarantine attribute:\n\u003e\n\u003e ```bash\n\u003e xattr -cr /Applications/Claude\\ Code\\ Trace.app\n\u003e ```\n\n### Run from source (no install)\n\n```bash\ngit clone git@github.com:delexw/claude-code-trace.git\ncd claude-code-trace\nnpm install\n\nnpm run tauri dev        # desktop app with hot reload\nnpm run dev:web          # web mode (opens browser)\nnpm run dev:tui          # TUI (starts backend + terminal UI)\n```\n\n## Requirements\n\n- [Rust](https://rustup.rs/) 1.77+\n- Node.js 18+\n- macOS: Xcode Command Line Tools (`xcode-select --install`)\n- Linux: `libwebkit2gtk-4.1-dev libayatana-appindicator3-dev librsvg2-dev libxdo-dev libssl-dev`\n- Windows: [WebView2](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) (pre-installed on Windows 10/11)\n\n## Usage\n\n```bash\ncctrace              # desktop app (default)\ncctrace --web        # web mode (opens browser at http://localhost:1420)\ncctrace --tui        # terminal UI (starts backend + TUI together)\n```\n\nLaunch to open the session picker. It auto-discovers all sessions from `~/.claude/projects/`.\n\nIn desktop mode, click **Open in Browser** in the toolbar to switch to browser mode — this opens `http://localhost:1420` in your default browser and hides the desktop window.\n\nIf you installed the pre-built `.dmg`/`.deb`/`.msi`, you can also launch the desktop app directly and pass `--web` to the binary:\n\n```bash\n# macOS\n/Applications/Claude\\ Code\\ Trace.app/Contents/MacOS/Claude\\ Code\\ Trace --web\n```\n\nSelect a session to view the conversation. Click messages to expand tool calls, or open the detail view for full inspection.\n\nMCP (Model Context Protocol) tool calls are automatically detected and displayed with human-friendly names. For example, `mcp__chrome-devtools__take_screenshot` renders as **MCP chrome-devtools** with the summary \"take screenshot\". Supported MCP servers include chrome-devtools, figma, atlassian, buildkite, cloudflare, and any other server following the `mcp__\u003cserver\u003e__\u003ctool\u003e` naming convention.\n\n### Keybindings\n\n`?` toggles keybind hints in any view.\n\n**List view**\n\n| Key               | Action                                  |\n| ----------------- | --------------------------------------- |\n| `j` / `k`         | Move cursor down / up                   |\n| `G` / `g`         | Jump to last / first message            |\n| `Tab`             | Toggle expand/collapse current message  |\n| `e` / `c`         | Expand / collapse all Claude messages   |\n| `Enter`           | Open detail view                        |\n| `d`               | Open debug log viewer                   |\n| `t`               | Open team task board (when teams exist) |\n| `s` / `q` / `Esc` | Open session picker                     |\n\n**Detail view**\n\n| Key         | Action                         |\n| ----------- | ------------------------------ |\n| `j` / `k`   | Navigate items                 |\n| `Tab`       | Toggle expand/collapse item    |\n| `Enter`     | Open subagent or toggle expand |\n| `h` / `l`   | Switch panels left / right     |\n| `q` / `Esc` | Back to list                   |\n\n**Session picker**\n\n| Key         | Action                |\n| ----------- | --------------------- |\n| `j` / `k`   | Navigate sessions     |\n| `Enter`     | Open selected session |\n| `q` / `Esc` | Back to list          |\n\n**Debug log viewer**\n\n| Key         | Action       |\n| ----------- | ------------ |\n| `q` / `Esc` | Back to list |\n\n## Development\n\n```bash\nnpm install\nnpm run tauri dev        # desktop app with hot reload\nnpm run dev:web          # web mode (opens browser, no desktop window)\nnpm run dev:tui          # TUI (starts backend + terminal UI together)\nnpm run tauri build      # production build\n```\n\n### Check \u0026 Test\n\n```bash\nnpm run check            # run all checks at once\nnpx vitest run           # frontend tests\ncargo test --manifest-path src-tauri/Cargo.toml    # Rust tests\nnpx tsc --noEmit         # TypeScript type check\nnpx oxlint               # JS/TS lint\nnpx oxfmt                # JS/TS format\ncargo clippy --manifest-path src-tauri/Cargo.toml  # Rust lint\ncargo fmt --manifest-path src-tauri/Cargo.toml     # Rust format\n```\n\n## Release\n\nPush a version tag to trigger a GitHub Actions build:\n\n```bash\ngit tag v0.4.0\ngit push origin v0.4.0\n```\n\nThis creates a draft release with macOS, Linux, and Windows artifacts attached. Review and publish it from the [Releases](https://github.com/delexw/claude-code-trace/releases) page.\n\n## License\n\n[MIT](LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelexw%2Fclaude-code-trace","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdelexw%2Fclaude-code-trace","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelexw%2Fclaude-code-trace/lists"}