GitHub - agentic-utils/ccs: Globally search and resume Claude Code conversations

ccs - Claude Code Search

Globally search and resume Claude Code conversations.

Features

Search through all your Claude Code conversations
Preview conversation context with search term highlighting
See message counts and hit counts per conversation
Resume conversations directly from the search interface
Delete conversations with confirmation prompt
Pass flags through to claude (e.g., --plan)
Mouse wheel scrolling support

Installation

Homebrew (macOS and Linux)

brew install agentic-utils/tap/ccs

From source

Requires Go 1.21+.

go install github.com/agentic-utils/ccs@latest

Manual

Download the binary from releases and add to your PATH.

Requirements

Claude Code - must be installed and used at least once

Usage

# Search recent conversations (last 60 days, files <1GB)
ccs

# Search with initial query
ccs buyer

# Search last 7 days only
ccs --max-age=7

# Search everything (all time, all files)
ccs --all

# Resume with plan mode
ccs -- --plan

# Combined: search "buyer", resume with plan mode
ccs buyer -- --plan

Flags

Flag	Default	Description
`--max-age=N`	60	Only search files modified in the last N days (0 = no limit)
`--max-size=N`	1024	Max file size in MB to include (0 = no limit)
`--all`	-	Include everything (same as `--max-age=0 --max-size=0`)

Keybindings

↑/↓ or Ctrl+P/N - Navigate list
Enter - Resume selected conversation
Ctrl+D - Delete selected conversation (with confirmation)
Ctrl+J/K - Scroll preview
Mouse wheel - Scroll list or preview (context-aware)
Ctrl+U - Clear search
Esc / Ctrl+C - Quit

How it works

ccs reads conversation history from ~/.claude/projects/ and presents them in an interactive TUI. When you select a conversation, it changes to the original project directory and runs claude --resume <session-id>.

License

MIT