ccsessions

ccsessions (from Claude Code Sessions) is a terminal UI for browsing Claude Code session history for the current working directory.

It maps the current directory to Claude's project history folder under ~/.claude/projects by default, or a custom Claude directory passed with --claude-dir, loads each .jsonl session file, and shows:

• a searchable session list
• session metadata such as timestamps and branch
• the full session log for the selected session

Run

go run ./cmd/ccsessions

To read sessions from a different Claude config directory:

go run ./cmd/ccsessions --claude-dir ~/.claude-personal

To show discovery diagnostics in the UI header:

go run ./cmd/ccsessions --claude-dir ~/.claude-personal --debug

Build

Build the binary into ./bin/ccsessions:

make build

Or build it directly with Go:

go build -o bin/ccsessions ./cmd/ccsessions

Install

Install ccsessions into your Go binary directory:

go install ./cmd/ccsessions

After that, run it with:

ccsessions

Or:

ccsessions --claude-dir ~/.claude-personal

You can combine it with:

ccsessions --debug

Controls

• Type to filter sessions
• Tab to cycle focus between search, session list, and session log
• j / k or arrow keys to move in the session list or scroll the session log when that pane is focused
• / in the session log pane to open inline search
• up / down in session log search to move between matches
• Enter to keep the current session log search active
• Esc to clear the current session log search
• q to quit

Notes

This repo depends on:

• github.com/charmbracelet/bubbletea
• github.com/charmbracelet/bubbles
• github.com/charmbracelet/lipgloss