sorafujitani/ccsession

ccsession

An fzf-powered session picker for resuming local agent sessions.

ccsession lists local agent sessions (Claude Code by default, with optional OpenCode, Grok, and Codex backends), 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, with configurable mode-switch keys.
• 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 — chdirs back to the session's original cwd before exec'ing the selected agent's resume command, so paths and tooling Just Work.
• Single static binary — written in Go with no cgo; bundles a pure-Go SQLite reader (for OpenCode support) and a small TOML parser for the optional config file.

Requirements

| Tool | Required for | | --- | --- | | fzf >= 0.58.0 | interactive picker | | claude (Claude Code CLI) | resuming sessions | | opencode | listing & resuming OpenCode sessions (only with --source=opencode) | | grok (Grok Build TUI) | listing & resuming Grok sessions (only with --source=grok) | | codex (Codex CLI) | listing & resuming Codex sessions (only with --source=codex) |

ccsession depends on newer fzf actions such as transform, rebind, unbind, disable-search, and change-nth. The newest of those, change-nth, landed in fzf 0.58.0, so older versions may start but the mode switch bindings will not work correctly.

Install

Go

go install github.com/so