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, Codex, Pi, Oh My Pi, Kiro CLI, and Cortex Code 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. Set
  CCSESSION_PREVIEW_MESSAGES to change the preview length.
- 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

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

Requires Go 1.25 or newer (the pure-Go SQLite reader for OpenCode support
needs it; see #52).

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 page, extract
it, and drop the binary…