https://github.com/sorafujitani/ccsession
pick any past Claude Code session via fzf, then resume it from the right cwd
https://github.com/sorafujitani/ccsession
anthropicanthropic claude claude-code cli developer-tools fzf golang session-management terminal
Last synced: 9 days ago
JSON representation
pick any past Claude Code session via fzf, then resume it from the right cwd
- Host: GitHub
- URL: https://github.com/sorafujitani/ccsession
- Owner: sorafujitani
- License: mit
- Created: 2026-05-26T01:13:48.000Z (15 days ago)
- Default Branch: main
- Last Pushed: 2026-05-30T05:15:24.000Z (11 days ago)
- Last Synced: 2026-05-31T01:03:05.557Z (10 days ago)
- Topics: anthropicanthropic, claude, claude-code, cli, developer-tools, fzf, golang, session-management, terminal
- Language: Go
- Homepage:
- Size: 2.02 MB
- Stars: 14
- Watchers: 0
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
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. In grep mode the matched query is highlighted in the
preview so you can spot the hit at a glance.
- **Faithful resume** — `chdir`s 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`](https://github.com/junegunn/fzf) | interactive picker |
| `claude` ([Claude Code CLI](https://docs.claude.com/en/docs/claude-code)) | resuming sessions |
## Install
### Go
```sh
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___.tar.gz` for your platform from the
[Releases](https://github.com/sorafujitani/ccsession/releases) page, extract
it, and drop the binary somewhere on your `PATH`:
```sh
tar xzf ccsession_0.1.0_darwin_arm64.tar.gz
install -m 0755 ccsession ~/.local/bin/
```
If macOS Gatekeeper complains:
```sh
xattr -d com.apple.quarantine ~/.local/bin/ccsession
```
### Nix flake
```sh
nix run github:sorafujitani/ccsession # one-off
nix profile install github:sorafujitani/ccsession # install into a profile
```
### Homebrew
```sh
brew install sorafujitani/tap/ccsession
```
The formula lives in
[`sorafujitani/homebrew-tap`](https://github.com/sorafujitani/homebrew-tap)
and GoReleaser refreshes it on every tagged release. `fzf` is installed as a
dependency; the `claude` CLI must be installed separately.
## Usage
```sh
ccsession # list -> fzf -> resume
ccsession list [--grep Q] [--regex] # emit TSV rows to stdout
ccsession preview [--query Q] [--regex] # render the preview pane (Q highlighted)
ccsession resume # 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; matches are highlighted in the preview |
| `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 ` on every keystroke). The current
query is also forwarded to the preview as `ccsession preview --query
`, which highlights its matches in the rendered messages.
3. On `Enter`, `ccsession resume ` resolves the session's original
`cwd`, `chdir`s into it, and `execve`s `claude --resume ` so the
resumed process fully replaces the picker.
## Development
```sh
nix develop # Go + fzf + gopls + goreleaser
go build ./cmd/ccsession
go test ./...
```
### Snapshot a release locally
```sh
goreleaser release --snapshot --clean --skip=publish
ls dist/
```
### Build with Nix
```sh
nix build
./result/bin/ccsession --version
```
## Contributing
Bug reports and pull requests are welcome at
. For larger changes, please
open an issue first to discuss what you'd like to change.
## License
[MIT](./LICENSE)