claude-turbo-search

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:

1. Check and install dependencies (ripgrep, fzf, jq, bun, qmd)
2. Configure fast file suggestions
3. Set up QMD MCP server for semantic search
4. Run cartographer to map the codebase
5. 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
/push	Manually upload memory database to your self-hosted dashboard
/pull	Download memory database from your self-hosted dashboard (fresh-clone restore)

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