Skip to content
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
Codex Lens dashboard: two sample Codex threads, one running and one idle, with its plan and a redacted token
The exported dashboard, run against the synthetic Codex home used by the tests.
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.

Codex Lens: 60-second quickstart
git clone https://github.com/willykeenan/codex-lens.git
cd codex-lens
python3 codex_lens.py list --since 72