codex-insights
v0.0.1
Published
Local-first Codex adoption coach for session analytics, friction detection, and workflow insights.
Maintainers
Readme
codex-insights
See whether you are adopting Codex efficiently. Local-first coach, zero telemetry.
What It Is
codex-insights reads your local Codex session logs and opens a localhost dashboard with:
- Codex adoption score with visible subscores
- Action-first coaching on what to fix next
- Repeat-mistake and savings opportunities
- Supporting analytics by session/day/model with drill-downs
Run Locally
git clone https://github.com/rahthakor/codex-insights.git
cd codex-insights
npm install
npm startThe npm package is not published yet, so the source install above is the supported path today.
Options
npm start -- --no-open # don't auto-open browser
node src/index.js --summary # compact JSON totals and exit
node src/index.js --json # full parsed JSON and exitcodex-insights uses fixed port 39741. If it is busy, the CLI exits and asks you to stop the conflicting service.
Dashboard UX
- Native date filtering with quick presets (
7D,30D,This Month,All) - Previous/next range stepping with
[and]keyboard shortcuts - Fast refresh with clear connection status and resilient fallback to previous snapshot
- Search shortcuts (
/ork) and native suggestions - Codex Adoption Coach: action-first summary, explicit trust labels, confidence-scoped trend calls, and visible score dimensions
- Supporting analytics: response-time distribution, parallel-session signals, top tool usage, and source-backed optimization playbooks
Data Sources
~/.codex/sessions/**/*.jsonl~/.codex/archived_sessions/*.jsonl(when present)~/.codex/history.jsonl(for first prompt text)- Respects
$CODEX_HOMEif set
Pricing Model
Cost uses OpenAI API-equivalent token pricing (input, cached input, output) as an estimate. This is useful for coaching and optimization trends even when you are on a subscription plan.
Privacy
All data stays local. The app only reads local files and serves a dashboard on localhost. It is not an OpenAI account-wide billing dashboard and it does not claim to measure objective code quality.
Credits
Inspired by claude-spend, with parser enhancements informed by CodexBar's Codex usage scanning approach.
License
MIT
