sorafujitani/ccsession

★ 14GoAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((ccsession))
    Search Modes
      Fuzzy metadata search
      Directory filter
      Full-text grep
    Features
      Live message preview
      Resume in original dir
      Keyboard navigation
    Install Options
      Go toolchain
      Pre-built binary
      Homebrew
      Nix
    Tech Stack
      Go
      fzf
      Claude Code CLI

mindmap root((ccsession)) Search Modes Fuzzy metadata search Directory filter Full-text grep Features Live message preview Resume in original dir Keyboard navigation Install Options Go toolchain Pre-built binary Homebrew Nix Tech Stack Go fzf Claude Code CLI

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Quickly find and resume a Claude Code session from last week without hunting for the session ID or folder.

USE CASE 2

Search through past Claude Code conversations by keyword to find where you discussed a specific bug or feature.

USE CASE 3

Jump back into a session in its original project directory so all file paths and tools work as they did before.

Tech stack

Gofzf

Getting it running

Difficulty · easy Time to first run · 5min

Requires fzf and the Claude Code CLI to be installed, available via Homebrew, Nix, or as a pre-built binary.

MIT license, use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

ccsession is a small command-line tool for developers who use Claude Code, Anthropic's AI coding assistant. Claude Code stores each conversation as a session file, and this tool makes it easy to find and resume any past session across all of your projects without remembering session IDs or navigating folders manually. When you run ccsession, it scans your Claude Code session history and presents all sessions in an interactive fuzzy-finder interface powered by a popular command-line tool called fzf. You can search sessions by time, project directory, or the actual content of past conversations. A live preview panel on the right shows the last 30 messages from whichever session you are looking at. When you press Enter, ccsession resumes the session inside its original working directory so that file paths and project-specific tools work exactly as they did when you last used it. There are three search modes accessible with keyboard shortcuts: the default fuzzy mode searches across all metadata, a directory mode restricts matching to folder names, and a grep mode searches through the full text of conversation transcripts and highlights the matching lines in the preview. The tool is written in Go and ships as a single static binary with no runtime dependencies beyond fzf itself and the Claude Code CLI. You can install it with the Go toolchain, download a pre-built binary from the releases page, use Homebrew on macOS, or install it through the Nix package manager. The project is open source under the MIT license.

Copy-paste prompts

Prompt 1

Install ccsession on macOS using Homebrew and show me how to run it to find a Claude Code session I had last week about a React bug.

Prompt 2

How does ccsession's grep search mode work? Show me how to search for all sessions where I discussed 'authentication' across all my projects.

Prompt 3

I want to add a filter to ccsession that shows only sessions from the last 7 days. Where in the Go code should I add that logic?

Open on GitHub → Explain another repo

← sorafujitani on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.