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