codex-session-browser
v0.1.0
Published
Browse, search, and resume local Codex CLI sessions.
Readme
codex-session-browser
Browse, search, and resume Codex CLI sessions from a terminal UI.
▶ Watch demo video
https://github.com/user-attachments/assets/9ae1f97f-9130-4d24-a89f-5882721bf46f
Install
npm install -g codex-session-browserOr with npx (no install):
npx codex-session-browserBoth expose two commands: codex-session-browser and the shorter alias codex-sessions.
Usage
codex-sessions # open the TUI for the current project
codex-sessions --all # open the TUI across all projects
codex-sessions --cwd # filter strictly to $PWDKeys
| Key | Action |
|---|---|
| / | enter search |
| ↑ ↓ | move selection (works in search too) |
| Enter | resume selected session |
| f | fork selected session |
| y | copy session id |
| a | toggle current-project / all-projects |
| Esc | clear search / exit search mode |
| q | quit |
Development
git clone <repo>
cd codex-session-browser
node bin/codex-session-browser.js --all # run directly
npm test # run the test suite