Released v0.1.0 · Viewer · CLI and Claude skill
Codex Lens
A read-only viewer for your local Codex threads.
A read-only viewer for local OpenAI Codex threads: lists every thread, infers live status and exports a redacted dashboard. Not affiliated with OpenAI.
codex-lens export · index.htmlSynthetic data

- Access
- Read-only
- Export
- Markdown · JSON · HTML
- Needs
- Python 3.9+
- License
- MIT
01 / What it does
A read-only viewer for your local Codex threads.
- 01
Every thread, with status
Lists threads and infers whether each is running, stalled, awaiting approval, waiting on you, aborted or idle.
- 02
What each one did
Current plan, commands and failures, files touched, git branch, token totals and context-window pressure.
- 03
Redacted dashboard
Exports a self-contained HTML dashboard with secrets redacted, and never writes inside your Codex home.
02 / The record
What it can prove, and where it stops.
- Proven safeguard
- Never writes inside CODEX_HOME, and the state database is opened read-only and immutable.
- Status
- Free · MIT · v0.1.0. Read the repository README for its full scope.
- License
- MIT
- Screens on this page
- Real captures of the product, from its demo mode, sample data or a recorded run. No customer data.
03 / Try it
Run it yourself.
60-second quickstart, from the repository README. Nothing here needs an account with us.
git clone https://github.com/willykeenan/codex-lens.git
cd codex-lens
python3 codex_lens.py list --since 72