ccsession

README

ccsession

An fzf-powered session picker for claude --resume.

ccsession lists every Claude Code session under ~/.claude/projects, lets you fuzzy-find across all of your projects with a live preview pane, and resumes the one you pick in its original working directory.

Features

• Cross-project listing — every session from every project in one view, sorted by last activity.
• Three search modes — fuzzy (default), directory-only, and full-text grep over JSONL transcripts.
• Live preview — last 30 messages of the highlighted session, with timestamps and roles.
• Faithful resume — chdirs back to the session's original cwd before exec'ing claude --resume, so paths and tooling Just Work.
• Single static binary — written in Go with only the standard library.

Requirements

Tool	Required for
fzf	interactive picker
claude (Claude Code CLI)	resuming sessions

Install

Go

go install github.com/sorafujitani/ccsession/cmd/ccsession@latest

Version metadata is recovered from runtime/debug.ReadBuildInfo, so ccsession --version works for go install builds as well.

Pre-built binaries

Grab the ccsession_<ver>_<os>_<arch>.tar.gz for your platform from the Releases page, extract it, and drop the binary somewhere on your PATH:

tar xzf ccsession_0.1.0_darwin_arm64.tar.gz
install -m 0755 ccsession ~/.local/bin/

If macOS Gatekeeper complains:

xattr -d com.apple.quarantine ~/.local/bin/ccsession

Nix flake

nix run github:sorafujitani/ccsession             # one-off
nix profile install github:sorafujitani/ccsession # install into a profile

Homebrew (planned)

A draft brews: section lives in .goreleaser.yaml. Once a sorafujitani/homebrew-tap repository is published, brew install sorafujitani/tap/ccsession will work.

Usage

ccsession                            # list -> fzf -> resume
ccsession list  [--grep Q] [--regex] # emit TSV rows to stdout
ccsession preview <id>               # render the preview pane
ccsession resume  <id>               # chdir to the session's cwd, exec `claude --resume`
ccsession --version
ccsession --help

Keys inside fzf

Key	Mode
Ctrl-G	grep — refilters by user/assistant content on every keystroke
Ctrl-O	dir — fuzzy match restricted to the directory column
Ctrl-F	fuzzy — default; matches across time / dir / label
Enter	resume the selected session
Esc	cancel

How it works

1. ccsession list walks ~/.claude/projects/*/, reads the tail of each JSONL transcript in parallel, and prints one TSV row per session (id, epoch, relative time, cwd basename, label).
2. fzf consumes the TSV. The three key bindings swap fzf's matcher between fuzzy mode, directory-only mode, and grep mode (which reloads via ccsession list --grep <query> on every keystroke).
3. On Enter, ccsession resume <id> resolves the session's original cwd, chdirs into it, and execves claude --resume <id> so the resumed process fully replaces the picker.

Development

nix develop                    # Go + fzf + gopls + goreleaser
go build ./cmd/ccsession
go test ./...

Snapshot a release locally

goreleaser release --snapshot --clean --skip=publish
ls dist/

Build with Nix

nix build
./result/bin/ccsession --version

Contributing

Bug reports and pull requests are welcome at https://github.com/sorafujitani/ccsession. For larger changes, please open an issue first to discuss what you'd like to change.

License

MIT