Claude Code Session Editor (ccsessed)

A TUI for browsing, selecting, and precisely editing Claude Code session history.

Note: This project was written primarily by Claude (Anthropic's Claude Code / Opus), with direction and review from @grtsinry43.

Features

• Two-step flow — pick a session first, then edit its messages
• Auto-discovery — finds the Claude sessions for the current directory
• Precise message editing — delete a specific debugging exchange while keeping the rest
• Visual transcript — message list with tool-call markers and timestamps
• Side-effect detection — flags messages that modified files
• Safe deletion — shows affected files before deleting, and keeps a backup
• Atomic tool pairs — deleting one half of a tool_use ↔ tool_result pair pulls in the other so the chain never orphans
• Image stripping — remove image attachments (including tool screenshots) so non-vision models stop erroring
• Chain repair — fixes broken parentUuid links

Quick start

# Run the latest published version directly — no install needed
npx ccsessed

# …or install it globally
npm install -g ccsessed
ccsessed

Run it from inside a project directory and it lists that project's sessions.

cd /path/to/your/project
ccsessed                       # list sessions for this directory
ccsessed <session-id>          # edit a specific session directly
ccsessed -p /other/project     # point at a different project path
ccsessed --repair              # repair a broken session chain
ccsessed --help

Requires Node.js >= 22.

Workflow

1. Pick a session — navigate with ↑↓, open with Enter.

2. Edit messages — Space to select messages, D to delete the selection, I to strip images, W to write changes to disk.

Keybindings

Session picker

Key	Action
↑/↓	Navigate sessions
Enter	Open the session
Q	Quit

Message editor

Key	Action
↑/↓	Navigate messages
Space	Select / deselect
Enter	Open details (or expand a sidechain group)
E	Edit message text
D	Delete the selection
I	Strip images (focused / selected / whole session)
Ctrl+A / Ctrl+X	Select all deletable / clear selection
W	Save and quit
B	Back to the session list
Q	Quit without saving
Esc	Close details / cancel

Text editor (when editing a message)

Key	Action
Enter	Save
Shift+Enter / Option+Enter / Ctrl+J	Insert a newline
↑↓←→	Move the cursor
Home / End	Start / end of line
Ctrl+A / Ctrl+E	Start / end of input
Esc	Cancel

Shift+Enter is only distinguishable in terminals that support the kitty keyboard protocol (iTerm2, ghostty, kitty, WezTerm, …). Elsewhere use Option+Enter or Ctrl+J.

Notes

1. Backups — a .bak file is written before saving.
2. Reload — after editing, run claude --resume to reload the session.
3. Side effects — deleting a message that wrote files does not revert those files on disk.
4. Chain — use --repair to fix broken parentUuid chains.

Development

This is a pnpm + Turborepo monorepo.

ccedit/
├── packages/
│   ├── core/     # parsing, serialization, pairing, repair, image-strip
│   ├── tui/      # React + Ink components and the CLI entry
│   └── shared/   # small utilities
└── scripts/
    └── package.cjs   # esbuild bundle → ./dist (publishable `ccsessed` package)

pnpm install
pnpm run dev               # watch mode
pnpm run test:integration  # run the test suite
pnpm -w run build          # build all packages
pnpm run package           # bundle a publishable ./dist

Publishing

scripts/package.cjs bundles the workspace into a single self-contained dist/ccsessed.js (with ink, react, and commander kept as external runtime dependencies) and stages a ready-to-publish package in ./dist:

pnpm run release
npm publish ./dist

Tech stack

• Runtime: Node.js >= 22
• TUI: React 19 + Ink 7
• Language: TypeScript
• Tooling: pnpm workspaces, Turborepo, esbuild

License

MIT