Skip to content

mblode/claude-code-search

Repository files navigation

ccs - Claude Code Search

npm version License: MIT

Like fzf or atuin, but for your Claude Code prompts.

ccs example

Why?

Your best prompts are buried across dozens of Claude Code sessions. This tool lets you instantly search and reuse them instead of rewriting from scratch.

Install

npm install -g claude-code-search

Usage

ccs                     # Launch interactive TUI
ccs -l                  # List recent prompts
ccs -s "refactor"       # Search for "refactor"
ccs -l -j               # Output as JSON
ccs -l -n 50            # List last 50 prompts
ccs -p /path/to/proj    # Filter by project path

Select a prompt and it's copied to your clipboard, ready to paste.

Pipe to Claude

Extract insights from your prompt history:

ccs -l | claude "what patterns do you see in how I prompt?"
ccs -s "refactor" -j | claude "summarize these prompts"

Features

  • Fuzzy search - Find prompts by any words they contain
  • Relevance ranking - Results sorted by match quality, not just date
  • Split-pane preview - See full content before selecting
  • Quick jump - Press 1-9 to instantly select
  • Filter modes - Search globally or within current directory
  • Non-interactive mode - Use with -l or -s for scripting
  • Color support - Respects NO_COLOR and FORCE_COLOR

CLI Options

Options:
  -l, --list            List all prompts (non-interactive)
  -s, --search <query>  Search prompts with query (non-interactive)
  -j, --json            Output as JSON (use with -l or -s)
  -n, --limit <n>       Limit number of results (default: 100)
  -p, --project <path>  Filter by project path
  -v, --version         Show version number
  -h, --help            Show help

Keyboard Shortcuts

Key Action
/ or j / k Navigate results
1-9 Quick jump to result
Enter Copy & exit
Ctrl+R / Shift+Tab Toggle global/directory filter
Esc / Ctrl+C Quit

Exit Codes

Code Meaning
0 Success
1 General error
2 Invalid arguments
3 No results found

Requirements

  • Node.js >= 18
  • Claude Code (reads from ~/.claude/projects/)

License

MIT - Matthew Blode

About

Search through your Claude Code history

Resources

License

Stars

Watchers

Forks

Sponsor this project

 

Packages

 
 
 

Contributors