Claude Turbo Search
Optimized file search and semantic indexing for large codebases in Claude Code.
Features
- Fast file suggestions - ripgrep + fzf for instant autocomplete
- Semantic search - QMD integration for finding relevant docs by meaning
- Cartographer integration - Automatic codebase mapping
- One command setup -
/turbo-index does everything
- QMD skill -
/qmd teaches Claude to search before reading files
- Optional hooks - Auto-inject relevant context before prompts
Requirements
Supported Platforms
| Platform | Package Manager | Status |
|---|
| macOS | Homebrew | Fully supported |
| Ubuntu/Debian | apt | Fully supported |
| Fedora/RHEL | dnf | Fully supported |
| Arch Linux | pacman | Fully supported |
| Windows | - | Not supported (use WSL) |
Prerequisites
- Claude Code CLI installed
- Bash 4.0+ (default on macOS and Linux)
- A supported package manager (see above)
Installation
Option 1: Install from GitHub (recommended)
Add the repository as a marketplace and install:
# Add the marketplace from GitHub (use #branch for specific branch)
claude plugin marketplace add iagocavalcante/claude-turbo-search
# Or install from a specific branch
claude plugin marketplace add "iagocavalcante/claude-turbo-search#feature/vector-search-rag"
# Install the plugin
claude plugin install claude-turbo-search@claude-turbo-search-dev
# Restart Claude Code to load the plugin
Option 2: From official marketplace (when published)
claude plugin install claude-turbo-search
Updating the Plugin
When updates are available:
# Update the marketplace to fetch latest changes
claude plugin marketplace update claude-turbo-search-dev
# Update the plugin
claude plugin update claude-turbo-search@claude-turbo-search-dev
# Restart Claude Code to apply updates
Verify Installation
claude plugin list
You should see:
❯ claude-turbo-search@claude-turbo-search-dev
Version: 1.0.0
Status: ✔ enabled
Usage
In any project, run:
/turbo-index
This will:
- Check and install dependencies (ripgrep, fzf, jq, bun, qmd)
- Configure fast file suggestions
- Set up QMD MCP server for semantic search
- Run cartographer to map the codebase
- Index all documentation with QMD
Subsequent runs
Running /turbo-index again will:
- Skip dependency installation
- Skip global configuration
- Refresh the project index if files changed
Available Skills
| Skill | Description |
|---|
/turbo-index | Set up optimized search indexing for a project |
/qmd | Search docs before reading to save tokens |
/remember | Save session context to persistent memory |
/memory-stats | View memory database statistics |
/token-stats | Show token economics and savings dashboard |
/knowledge-graph | Interactive TUI knowledge graph viewer for the memory database |
Using the QMD Skill
After indexing, use /qmd or just ask Claude to search:
"Search for authentication logic in this project"
"Find files related to database migrations"
Claude will use QMD to find relevant files before reading them, saving significant tokens.
Using Memory Skills
Track your work across sessions:
# At end of session, save context to memory
/remember
# View accumulated knowledge
/memory-stats
# See token savings in action
/token-stats
The memory system uses SQLite FTS5 for instant search across all your saved sessions, knowledge, and facts.
Knowledge Graph
Visualize entity relationships in your memory database:
# Full dashboard (stats + graph + timeline)
/knowledge-graph
# Individual views
/knowledge-graph stats # Counts, categories, top entities bar chart
/knowledge-graph graph # Entity tree + relation edges + co-occurrences
/knowledge-graph timeline # Chronological session/knowledge entries
/knowledge-graph explore auth # Drill into a specific entity
Uses Rich for colored TUI output, with automatic plain-text fallback. See docs/knowledge-graph-setup.md for detailed setup.
Manual QMD Commands
# Fast keyword search (use this first)
qmd search "your query" --files -n 10
# Semantic search (slower, use as fallback)
qmd vsearch "how does the login flow work"
# Get specific file content
qmd get "path/to/file.md"
Optional: Auto-Context Hooks
Enable automatic context injection that searches QMD before each prompt:
# Simple mode - suggests relevant file paths (lightweight)
~/claude-turbo-search/scripts/setup-hooks.sh
# RAG mode - injects actual content snippets (recommended)
~/claude-turbo-search/scripts/setup-hooks.sh --rag
# Remove hooks
~/claude-turbo-search/scripts/setup-hooks.sh --remove
Hook Modes Comparison
iagocavalcante