Threadlens
Search, review, back up, and safely clean up local sessions from Codex, Claude, Gemini, and Copilot.
Install
git clone https://github.com/hanityx/threadlensInstall command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →ThreadLens
한국어 · 中文 · 日本語 · Español · Português
You remember the conversation — you just don't know if it was Codex, Claude, Gemini, or Copilot.
ThreadLens lets you search, open and review conversations, analyze impact, back up, and safely clean up your local AI sessions from one place. No cloud, no account — just the sessions already on your machine.
| Before | With ThreadLens |
|---|---|
| Grep through hidden provider folders | Search across Codex, Claude, Gemini, and Copilot at once |
| Forget which tool had the answer | Open matching transcripts directly |
| Cleanup requires touching files directly | Backup first, review impact, then clean up safely |
| Desktop, web, and terminal workflows drift apart | Same local API across desktop, web, and TUI |
Features
- Search — find sessions across Codex, Claude, Gemini, and Copilot with a single keyword.
- Transcript — open full conversations without navigating provider-specific folders.
- Safe cleanup — back up first, preview with dry-run, and require a confirmation token before deleting local files safely.
- Thread review — inspect Codex thread scope, related sessions, and audit history.
- Provider health — provider status, session discovery flow, and path/config issues on one screen.
- TUI — the same workflows in your terminal, keyboard-first.
See Provider support for path details, limitations, and current support scope.
Getting Started
Desktop
macOS .dmg ↗ · Windows .exe ↗ · Linux .AppImage ↗
macOS and Windows builds are unsigned.
Source
Requires Node.js 22.12+ and pnpm 10.33.2+.
git clone https://github.com/hanityx/threadlens.git
cd threadlens
pnpm install && pnpm dev
| Command | Description |
|---|---|
pnpm dev |
web UI :5174 · API :8788 |
pnpm dev:tui |
terminal workbench |
pnpm dev:desktop |
Electron desktop |
Roadmap
Upcoming releases focus on:
- 0.3.x — bug fixes and release stability, provider reliability improvements, general UX improvements
- 0.4 — session navigation, backup visibility, error guidance, session impact analysis
Documentation
Contributing
Bug reports, feature suggestions, provider support improvements, and code contributions of all kinds are welcome.
License
MIT
Similar plugs
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
Bash is all you need - A nano claude code–like 「agent harness」, built from 0 to 1
Documented system prompts from Anthropic - Claude Fable 5.1, Opus 5.5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro,…
Wrap Antigravity, ChatGPT Codex, Claude Code, Grok Build, Muse Code, Devin as an OpenAI/Gemini/Claude/Codex compatible API service, allowing you to enjoy the free Gemini…