codex-sessions

Terminal-first session manager for Codex CLI.

Why TUI

This tool stays in the same workflow as Codex CLI:

• terminal-native interaction
• no web server
• no localhost browser surface

Features

• List sessions from ~/.codex/sessions
• Rename session display names (stored in ~/.codex/session-manager-meta.json)
• Delete sessions (moves files to ~/.codex/session_trash)
• Copy sessions (copies .jsonl files into ~/.codex/session_exports)
• Duplicate sessions (creates a new session file with a new UUID)

Install

npm install -g @simonsbs/codex-sessions

Usage

Interactive TUI mode:

codex-sessions

Command mode:

codex-sessions list
codex-sessions list --json
codex-sessions rename <sessionId> "New Name"
codex-sessions delete <sessionId>
codex-sessions copy <sessionId>
codex-sessions duplicate <sessionId>

Compatibility alias:

codex-session-tui

Options:

• --codex-home <path> override the Codex home directory (default ~/.codex)

Examples

List sessions (tabular):

codex-sessions list

Rename a session and verify it appears in the list:

codex-sessions rename 019cbdc9-7be5-7ac0-adf7-0c60e90a2c83 "Project kickoff"
codex-sessions list

Copy a session JSONL to export folder:

codex-sessions copy 019cbdc9-7be5-7ac0-adf7-0c60e90a2c83
# output includes path in ~/.codex/session_exports

Duplicate a session to create a new session ID:

codex-sessions duplicate 019cbdc9-7be5-7ac0-adf7-0c60e90a2c83

Delete a session safely to trash folder:

codex-sessions delete 019cbdc9-7be5-7ac0-adf7-0c60e90a2c83
# moved to ~/.codex/session_trash

Use a custom Codex home path:

codex-sessions list --codex-home /path/to/custom/.codex

Output format (list)

Columns:

• #
• ID (full UUID)
• Modified
• Prompt

If a custom name exists, prompt column starts with:

• <custom-name> | <prompt-preview>

Changelog

• CHANGELOG.md

Open-source docs

• License
• Contributing
• Code of Conduct
• Security