{"id":50325303,"url":"https://github.com/testy-cool/cc-convo-explorer","last_synced_at":"2026-05-29T05:30:58.700Z","repository":{"id":349992004,"uuid":"1203642548","full_name":"testy-cool/cc-convo-explorer","owner":"testy-cool","description":"TUI for browsing, searching, exporting, and analyzing Claude Code conversation history","archived":false,"fork":false,"pushed_at":"2026-05-02T22:16:08.000Z","size":168,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-03T00:30:14.799Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","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/testy-cool.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":null,"dco":null,"cla":null}},"created_at":"2026-04-07T08:24:10.000Z","updated_at":"2026-05-02T22:16:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/testy-cool/cc-convo-explorer","commit_stats":null,"previous_names":["testy-cool/convo-explorer","testy-cool/cc-convo-explorer"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/testy-cool/cc-convo-explorer","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fcc-convo-explorer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fcc-convo-explorer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fcc-convo-explorer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fcc-convo-explorer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/testy-cool","download_url":"https://codeload.github.com/testy-cool/cc-convo-explorer/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testy-cool%2Fcc-convo-explorer/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33639050,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-29T02:00:06.066Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":[],"created_at":"2026-05-29T05:30:58.579Z","updated_at":"2026-05-29T05:30:58.681Z","avatar_url":"https://github.com/testy-cool.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cc-convo-explorer\n\nA terminal UI for browsing, searching, resuming, and analyzing your [Claude Code](https://docs.anthropic.com/en/docs/claude-code) conversation history.\n\nClaude Code stores every session as `.jsonl` files in `~/.claude/projects/`. This tool gives you a searchable, interactive interface to explore them all — across every project you've ever worked on.\n\n## Screenshot\n\n```\n cc-convo-explorer\n ┌─ PROJECTS (12) ────────────────┐┌─ PREVIEW (25 turns) ──────────────────────┐\n │ Filter convos... (Enter=search) ││                                            │\n │                                  ││ ## ticklish-twirling-hejlsberg             │\n │ ~/Work/my-project      (12) ★  ││ Date: 2026-04-06T21:11:48                  │\n │ ~/Work/web-app          (36)    ││ CWD: ~/Work/my-project                     │\n │ ~/Work/api-server      (116) ★ ││ ──────────────────────────────────────────  │\n │ ~/Work/cli-tool          (6)    ││ ## User                                    │\n │ ✓ ~/Work/dashboard      (24)    ││ would like to make this more profesh...    │\n │ ✓ ~/Work/shared-lib      (8)    ││                                            │\n │   2026-04-05  fix-auth  ...     ││ ## Assistant                               │\n │   2026-04-03  refactor  ...     ││ Let me explore the codebase first...       │\n │                                  ││                                            │\n ├──────────────────────────────────┤│                                            │\n │ 2 selected · ~850K tokens       ││                                            │\n │ / search · S select · A analyze ││                                            │\n └──────────────────────────────────┘└────────────────────────────────────────────┘\n```\n\n## Features\n\n- **Browse all projects** — auto-discovers every Claude Code project in `~/.claude/projects/`\n- **Tree view** — expandable project nodes with conversation children, sorted by date\n- **Search/filter** — type to filter instantly, press Enter for deep full-text search\n- **Resume sessions** — press `R` to resume any conversation with `claude -r`\n- **Preview** — select any conversation to see the full user/assistant exchange\n- **Multi-select** — select individual conversations, entire projects, or everything\n- **Token estimation** — see estimated token count for selected conversations\n- **Export** — export individual conversations or combined multi-conversation markdown\n- **Gemini analysis** (optional) — analyze conversations with Google Gemini to extract patterns, preferences, and insights\n- **Model picker** — cycle between Gemini models\n- **Editable prompts** — customize the analysis prompt before running\n- **Analyzed indicators** — projects that have been analyzed show a ★ marker\n- **Resizable sidebar** — drag the divider to resize\n- **CLI mode** — list, search, export, resume, and analyze without the TUI\n\n## Install\n\n```bash\n# Install globally (recommended)\nuv tool install \"cc-convo-explorer[ai] @ git+https://github.com/testy-cool/cc-convo-explorer.git\"\n\n# Or clone and install locally\ngit clone https://github.com/testy-cool/cc-convo-explorer.git\ncd cc-convo-explorer\nuv sync --extra ai\n```\n\nRequires Python 3.12+ and [uv](https://docs.astral.sh/uv/).\n\n## Usage\n\n### TUI (interactive)\n\n```bash\ncc-convo-explorer\n```\n\n**Keyboard shortcuts:**\n\n| Key | Action |\n|-----|--------|\n| `/` | Focus search/filter |\n| `Enter` | Deep search (in filter) / Preview conversation (in tree) |\n| `Esc` | Clear filter / Cancel analysis |\n| `S` | Toggle select on current item |\n| `Ctrl+A` | Select all |\n| `Ctrl+D` | Deselect all |\n| `R` | Resume conversation in Claude Code |\n| `E` | Export selected as individual markdown files |\n| `C` | Export selected as one combined markdown file |\n| `A` | Analyze with Gemini |\n| `M` | Cycle Gemini model |\n| `P` | Edit analysis prompt |\n| `O` | Open exports/analyses folder |\n| `Tab` | Switch focus between sidebar and preview |\n| `Q` | Quit |\n\n### CLI (headless)\n\n```bash\n# List all projects and conversations\ncc-convo-explorer --list\n\n# Search across all conversations\ncc-convo-explorer --search \"auth middleware\"\n\n# Resume a conversation by slug or UUID\ncc-convo-explorer --resume reflective-herding-biscuit\n\n# Export by file path, UUID prefix, or slug\ncc-convo-explorer --concat path/to/session.jsonl\ncc-convo-explorer --concat 315ce500\ncc-convo-explorer --concat reflective-herding-biscuit\n\n# Analyze with Gemini\nexport GEMINI_API_KEY=your-key-here\ncc-convo-explorer --analyze 315ce5 reflective-herding --model gemini-3.1-pro-preview\n\n# Custom analysis prompt (inline or from file)\ncc-convo-explorer --analyze 315ce5 --prompt \"List all tools used.\\n\\n{content}\"\ncc-convo-explorer --analyze 315ce5 --prompt my-prompt.txt\n\n# Detail levels: text (default), tools, results, full\ncc-convo-explorer --concat 315ce5 --detail tools     # +tool call summaries\ncc-convo-explorer --concat 315ce5 --detail results   # +truncated tool output\ncc-convo-explorer --concat 315ce5 --detail full      # +everything untruncated\n```\n\n#### Detail levels\n\n| Level | What's included | Typical overhead |\n|-------|----------------|-----------------|\n| `text` | User/assistant text only | baseline |\n| `tools` | + tool call summaries (Bash commands, file edits, greps) | +20-30% |\n| `results` | + truncated tool output (500 chars each) | +80-100% |\n| `full` | + full untruncated tool output | +300-2000% |\n\nExports include a stats header: model, token count, duration, tool calls, and estimated cost.\n\n## Gemini Analysis\n\nSet your API key:\n\n```bash\n# Environment variable\nexport GEMINI_API_KEY=your-key-here\n\n# Or .env file in project directory\necho GEMINI_API_KEY=your-key-here \u003e .env\n```\n\nGet a free key at [aistudio.google.com](https://aistudio.google.com/apikey).\n\nAnalysis extracts:\n- Key decisions and their rationale\n- User preferences and workflow patterns\n- Problems encountered and solutions\n- Recurring patterns across sessions\n- Unfinished work and TODOs\n\nResults saved to `~/.claude/convo-explorer/analyses/`.\n\nFor multi-conversation analysis, select multiple items and press `A` — Gemini finds cross-session patterns and preference evolution.\n\n## File locations\n\n| What | Where |\n|------|-------|\n| Conversation logs | `~/.claude/projects/{project}/*.jsonl` |\n| Analyses | `~/.claude/convo-explorer/analyses/` |\n| Combined exports | `~/.claude/convo-explorer/exports/` |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesty-cool%2Fcc-convo-explorer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftesty-cool%2Fcc-convo-explorer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftesty-cool%2Fcc-convo-explorer/lists"}