A character user interface (CUI) tool for browsing and resuming OpenAI Codex CLI sessions.
⚠️ DISCLAIMER: This is an unofficial third-party tool not affiliated with or endorsed by OpenAI. Use at your own risk.
cdxresume provides an interactive terminal interface to browse and manage your Codex CLI session history. It reads session data from your local Codex CLI logs and displays them in an easy-to-navigate format.
Important compatibility note (Codex 0.32.0+):
~/.codex/sessions/YYYY/MM/DD/*.jsonl.--resume (interactive picker) and --continue (latest session). cdxresume remains compatible and valuable as a session browser and launcher. See the release notes: rust-v0.30.0.--resume <sessionId> (or --session-id <uuid>). For older Codex builds, it falls back to -c experimental_resume=<path-to-jsonl>.ccresume (a Claude Code tool): https://github.com/sasazame/ccresume. It is not a GitHub fork; it is a new repository derived from the original concept and components.. argument
npx cdxresume@latest
npm install -g cdxresume
Run the command in your terminal:
cdxresume
Or if using npx:
npx cdxresume@latest
# Hide specific message types
cdxresume --hide # Default: hides tool and thinking messages
cdxresume --hide tool # Hide only tool messages
cdxresume --hide user # Hide only user messages
cdxresume --hide assistant # Hide only assistant messages
cdxresume --hide tool user # Hide multiple types
# Filter to current directory
cdxresume .
# Show help
cdxresume --help
cdxresume -h
# Show version
cdxresume --version
cdxresume -v
All unrecognized command-line arguments are passed directly to the codex command when resuming a conversation.
# Pass options to codex
cdxresume --some-codex-flag
# Combine cdxresume and codex options
cdxresume --hide tool --model opus
cdxresume . --hide --some-codex-flag
Notes:
--resume or --continue, Codex’s native picker/auto-resume takes over (cdxresume’s selection will be ignored).--resume/--continue yourself. cdxresume will prefer native --resume/--session-id automatically when supported, and only fall back to -c experimental_resume=<path> on older Codex builds.Press - to open the command editor, where you can configure Codex CLI options before starting or resuming a session. The editor provides:
- to see matching Codex optionsThe configured options will be passed to Codex when you start a new session (n) or resume a conversation (Enter).
Note: The options list is based on Codex's help text at a specific point in time. Please refer to codex --help for the latest available options.
| Action | Keys |
|---|---|
| Quit | q |
| Select Previous | ↑ |
| Select Next | ↓ |
| Confirm/Resume | Enter |
| Start New Session | n |
| Edit Command Options | - |
| Copy Session ID | c |
| Scroll Up | k |
| Scroll Down | j |
| Page Up | u, PageUp |
| Page Down | d, PageDown |
| Scroll to Top | g |
| Scroll to Bottom | G |
| Next Page | → |
| Previous Page | ← |
| Toggle Full View | f |
You can customize key bindings by creating a configuration file at ~/.config/cdxresume/config.toml:
[keybindings]
quit = ["q", "ctrl+c", "esc"]
selectPrevious = ["up", "k"]
selectNext = ["down", "j"]
confirm = ["enter", "l"]
copySessionId = ["y"]
scrollUp = ["u", "ctrl+u"]
scrollDown = ["d", "ctrl+d"]
scrollPageUp = ["b", "ctrl+b"]
scrollPageDown = ["f", "ctrl+f"]
scrollTop = ["g"]
scrollBottom = ["shift+g"]
pageNext = ["right", "n"]
pagePrevious = ["left", "p"]
startNewSession = ["n"]
openCommandEditor = ["-"]
toggleFullView = ["f"]
See config.toml.example in the repository for a complete example.
# Clone the repository
git clone https://github.com/yourusername/cdxresume.git
cd cdxresume
# Install dependencies
npm install
# Run in development mode
npm run dev
# Build the project
npm run build
# Run tests
npm test
# Run tests in watch mode
npm run test:watch
# Generate test coverage
npm run test:coverage
# Run linter
npm run lint
# Type check
npm run typecheck
cdxresume/
├── src/ # Source code
│ ├── cli.tsx # CLI entry point
│ ├── App.tsx # Main application component
│ └── ... # Other components and utilities
├── dist/ # Compiled output
├── tests/ # Test files
└── package.json # Project configuration
Contributions are welcome! Please feel free to submit a Pull Request.
git checkout -b feature/AmazingFeature)git commit -m 'Add some AmazingFeature')git push origin feature/AmazingFeature)MIT
For issues and feature requests, please use the GitHub issue tracker.
-c experimental_resume=<path>, behavior may differ from Codex’s built‑in --resume picker. If you prefer a Codex‑managed resume flow, pass --resume to use the native picker.Remember: This is an unofficial tool. For official OpenAI Codex CLI support, please refer to OpenAI's documentation.
FAQs
A TUI tool for browsing and resuming Codex CLI conversations
The npm package cdxresume receives a total of 1 weekly downloads. As such, cdxresume popularity was classified as not popular.
We found that cdxresume demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Multiple high-impact npm maintainers confirm they have been targeted in the same social engineering campaign that compromised Axios.
Security News
Axios compromise traced to social engineering, showing how attacks on maintainers can bypass controls and expose the broader software supply chain.
Security News
Node.js has paused its bug bounty program after funding ended, removing payouts for vulnerability reports but keeping its security process unchanged.