GitHub - Tobiadefami/codex-explorer · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
Tobiadefami
codex-explorer
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>40 Commits<br>40 Commits
.github/workflows
.github/workflows
src
src
tests
tests
.gitignore
.gitignore
CONTRIBUTING.md
CONTRIBUTING.md
Cargo.lock
Cargo.lock
Cargo.toml
Cargo.toml
LICENSE
LICENSE
README.md
README.md
SECURITY.md
SECURITY.md
View all files
Repository files navigation
Codex Explorer
Codex Explorer is a local Codex session manager. The cx command indexes ~/.codex/sessions/**/*.jsonl so you can search, preview, and resume old Codex sessions without remembering the exact date.
Codex Explorer is early, work-in-progress software. It is useful today, but the data model and interface are still evolving.
Codex Explorer is an independent project and is not affiliated with, endorsed by, or sponsored by OpenAI.
Requirements
Rust and Cargo
The Codex CLI available as codex on your PATH for cx resume
A terminal with TUI support
Install
From this checkout:
cargo install --path . --locked
Cargo installs the cx binary into ~/.cargo/bin. Make sure that directory is on your PATH, then verify the installed command:
cx --version
To reinstall from a newer checkout:
cargo install --path . --locked --force
From GitHub:
cargo install --git https://github.com/Tobiadefami/codex-explorer --locked
Commands
cx resume ">cx<br>cx reindex<br>cx list<br>cx search "turnstile worker"<br>cx show session-id><br>cx resume session-id>
Run cx without a command to open the terminal session browser. The browser opens immediately with cached sessions and refreshes the index in the background.
TUI keys:
type to search
Backspace edits search
Up/Down moves selection
a shows all projects
p returns to the current directory
PgUp/PgDn scrolls the preview
Enter resumes the selected session
Esc quits
q quits when the search box is empty
Local Data
cx stores its search index in your platform data directory under cx/index.sqlite. On Linux this is typically ~/.local/share/cx/index.sqlite.
The index is local SQLite data. It contains session metadata, source file paths, titles, searchable text, and full user/assistant message text so cx show, search, and previews work without reparsing every JSONL file each time. Treat this index as private local data, because Codex sessions may contain prompts, code, file paths, command output, and other sensitive project context. Use --db to write the index somewhere else.
cx reads Codex session files from ~/.codex/sessions by default. Use --sessions-dir to index a different directory.
Development
Run tests:
cargo test
Run the full local check before opening a pull request:
cargo fmt --check<br>cargo test<br>cargo clippy --all-targets -- -D warnings<br>cargo package --allow-dirty --no-verify --offline
Run against fixture data:
cargo run -- --db /tmp/cx.sqlite --sessions-dir tests/fixtures reindex<br>cargo run -- --db /tmp/cx.sqlite search turnstile
License
MIT
About
No description, website, or topics provided.
Resources
Readme
License
MIT license
Contributing
Contributing
Security policy
Security policy
Uh oh!
There was an error while loading. Please reload this page.
Activity
Stars
stars
Watchers
watching
Forks
forks
Report repository
Releases
No releases published
Packages
Uh oh!
There was an error while loading. Please reload this page.
Contributors
Uh oh!
There was an error while loading. Please reload this page.
Languages
Rust<br>100.0%
You can’t perform that action at this time.