claude-session-browser

A terminal UI for browsing and resuming Claude Code sessions system-wide.

Reads .jsonl session files from ~/.claude/projects/, lets you search and navigate them, and execs claude --resume <session_id> in the project's original working directory.

Install

From a local clone:

make install     # pipx install from local source
make uninstall   # pipx uninstall

Requires Python 3.10+ and pipx.

Usage

claude-session-browser [--flat] [--restore] [--projects-dir DIR]

Launch with no arguments for the default tree view:

claude-session-browser

Tree view (default)

Two-panel layout: projects on top, sessions below. Type to filter in real time.

Key	Action
↑ / ↓	Navigate list
Tab	Switch between panels
Enter	Select / confirm
d	Delete selected session
Esc	Cancel / quit
q	Quit

Flat view

Single list of all sessions sorted by date.

claude-session-browser --flat

Delete a session

Press d on any session to open a confirmation dialog. You can optionally back up the session before deleting — the backup is stored in ~/.claude/backups/.

Restore a backup

claude-session-browser --restore

Opens a list of all backups. Select one to restore it to its original location.

Flags

Flag	Effect
--flat	Single-screen list of all sessions sorted by date
--restore	Browse backups and restore a selected session
--projects-dir	Override sessions directory (default: ~/.claude/projects)

Development

pdm install                       # install deps + editable package
pdm run claude-session-browser             # run the TUI
pdm run pytest                    # run all tests
pdm run pytest --snapshot-update  # regenerate UI snapshot baselines