Browse, search, and resume Codex CLI sessions from a terminal UI.
Watch demo video
demo.mov
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.
codex-sessions # open the TUI for the current project
codex-sessions --all # open the TUI across all projects
codex-sessions --cwd # filter strictly to $PWD| 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 |
git clone <repo>
cd codex-session-browser
node bin/codex-session-browser.js --all # run directly
npm test # run the test suite