codex-session-tui

npx -y codex-session-tui

Demo

Features

• Fast search/filter (/) across session metadata/content
• Parse/session-index JSONL files from ${CODEX_HOME:-~/.codex}/sessions
• Group sessions by project cwd
• 3-pane TUI: Projects, Sessions, Preview
• Operations: move, copy, fork, delete, project-folder rename/copy
• Multi-select sessions and bulk operations
• Foldable preview blocks, mouse selection/copy, draggable splitters/scrollbars

Motivation

codex resume groups sessions by stored cwd.
After a repo/folder move, old sessions can become hard to discover.

Why

codex-session-tui is a Rust TUI to inspect and remap Codex sessions safely.

Quickstart

Install globally:

npm i -g codex-session-tui
codex-session-tui
# press "/" to open search quickly

Use a different Codex home:

CODEX_HOME=/path/to/.codex codex-session-tui
# press "/" to open search quickly

or with npx:

CODEX_HOME=/path/to/.codex npx -y codex-session-tui
# press "/" to open search quickly

Platforms

Prebuilt binaries are published for:

• Linux: x86_64, aarch64, armv7
• macOS: x86_64, aarch64
• Windows (MSVC): x86_64, aarch64

Dev Run

cargo run

CODEX_HOME=/path/to/.codex cargo run

Safety

• Backups are created before mutating/deleting session files
• Writes use atomic temp-file + rename
• Unknown JSON fields are preserved

Backup location and restore:

• Backups are created next to the original session file under ${CODEX_HOME:-~/.codex}/sessions
• Backup filename format: <original>.jsonl.bak.YYYYMMDDHHMMSS

Find backups:

find "${CODEX_HOME:-$HOME/.codex}/sessions" -type f -name "*.jsonl.bak.*"

Restore a backup:

cp "/path/to/rollout-....jsonl.bak.20260224101530" "/path/to/rollout-....jsonl"