What is Codebase Curator?

The Problem

The Solution: Two-Claude Architecture

You (Coding Claude) → "How do I add authentication?"         ↓Codebase Curator → Spawns Curator Claude         ↓Curator Claude → Deeply analyzes your codebase         ↓You get → Specific guidance that fits YOUR patterns

✨ Key Features

🤖 Two-Claude Architecture

🔍 Smart Grep - Semantic Search That Understands Code

🚀 NEW: Compact Mode for Claudes (90% Less Context Usage!)

# Default: Compact summary (perfect for Claudes)smartgrep"authService"══════════════════════════════════════════════════════════════════════🔍 SMARTGREP:"authService" (17 resultsin 4 files)📍 DEFINITION: auth/service.ts:42 (CLASS)export class AuthService {   constructor(db: Database, cache: Cache)🔥 TOP USAGE:   • api/routes.ts:     - Line 15: authService.authenticate(username, password)     - Line 23: authService.validateToken(token)   • middleware/auth.ts:12 -if (!authService.isValid(token))⚡ BREAKING CHANGES (if you modify this):   •LoginController.handleLogin() - callsauthenticate()   •AuthMiddleware.verify() - callsvalidateToken()💡 PATTERNS DETECTED:   • Always async/await calls   • Throws: AuthenticationError, TokenExpiredError🎯 NEXT: smartgrep refs"authService"| smartgrep"authenticate"══════════════════════════════════════════════════════════════════════# Need full details? Use --full flagsmartgrep"authService" --full# Complete analysis with all matches

Core Features

# Don't just search - understand!smartgrep"handleAuth"# Shows where it's used + usage countsmartgrep refs"apiClient"# Full impact analysis - see all referencessmartgrep group auth# Search ALL auth patterns at oncesmartgrep changes# Analyze your uncommitted changes impactsmartgrep changes --compact# Quick risk assessment before committingsmartgrep"func NewAuth"# Go functionssmartgrep"impl Auth"# Rust implementationssmartgrep"protocol Auth"# Swift protocolssmartgrep"function deploy"# Shell scripts# Returns organized results with usage counts:# → Functions: authenticate() (12 uses), validateUser() (5 uses)# → Classes: AuthService, AuthMiddleware# → Config: JWT_SECRET, AUTH_URL, oauth settings# → Cross-references: Shows actual calling code with file:line locations# Advanced patternssmartgrep"error&handler"# AND searchsmartgrep"login|signin|auth"# OR searchsmartgrep"!test" --typefunction# Exclude tests# Custom concept groups for your projectsmartgrep group add payments charge,bill,invoice,transactionsmartgrep group payments --typefunction# Search your custom group

🌐 Language Support - Now 14 Languages + Frameworks!

🎯 Live Monitoring Dashboard

# Watch your codebase evolve in real-timebun run monitor watch --overview# See:# → Live code distribution by type# → File changes as they happen# → Most complex files by declaration count# → Automatic reindexing on changes

🧠 Persistent Understanding

🚀 Real Examples

# Overview - The foundation (takes ~2 minutes)"Give me an overview of this codebase"→ Curator explores everything, understands patterns# Follow-up questions are instant and accurate"How does authentication work?"→ Immediate response with YOUR specific implementation"Where should I add a payment feature?"→ Knows your patterns, suggests the right location

📦 Installation

Prerequisites

Quick Start

git clone https://github.com/RLabs-Inc/codebase-curator.gitcd codebase-curatorbun installbun link# Makes commands available globally

{"mcpServers": {"codebase-curator": {"command":"bun","args": ["run","/path/to/codebase-curator/src/mcp-servers/codebase-curator/server.ts"]    }  }}

🎯 Usage

In Claude Code

Use the set_project_path tool:Path: /path/to/your/project

Use the get_codebase_overview tool

Use ask_curator: "How does the payment system work?"Use add_new_feature: "Add user notifications"Use implement_change: "Fix the login timeout bug"

Smart Grep CLI - Semantic Search Made Simple

# After installation with bun link, use from anywhere:# Concept groups - search semantic patternssmartgrep group auth# ALL auth patterns (login, jwt, token...)smartgrep group error# ALL error patterns (exception, fail...)smartgrep group api# ALL API patterns (endpoint, route...)smartgrep group list# See all 20+ concept groups# NEW: Analyze your changes before committing!smartgrep changes# Full impact analysis of uncommitted changessmartgrep changes --compact# Quick risk assessment (one line)# Advanced search patternssmartgrep"user|auth"# OR searchsmartgrep"async&function"# AND searchsmartgrep"!test" --typefunction# Exclude testssmartgrep refs"PaymentService"# Find all usages# Custom groups for your projectsmartgrep group add payments charge,bill,invoice,transactionsmartgrep group payments# Use your custom group# Type filters for precisionsmartgrep"auth" --typefunction# Only functionssmartgrep"error" --type string# Only string literalssmartgrep group api --type class# Only API classes# Sort and format optionssmartgrep group service --sort usage# Most used firstsmartgrep"user" --compact# One line per resultsmartgrep"api" --json# Machine-readable output

🏗️ Architecture

Monorepo Structure

src/├── packages/               # Distributable packages│   ├── semantic-core/      # Core indexing engine│   ├── smartgrep/          # Semantic search CLI│   └── codebase-curator/   # Full suite├── services/               # Shared business logic├── tools/                  # CLI interfaces├── mcp-servers/            # AI interfaces└── shared/                 # Common utilities

Two-Claude System

Smart Components

🤝 Contributing

Development

# Install workspace dependenciesbun install# Run testsbuntest# Run MCP server locallybun run mcp# Run CLI toolsbun run start# Curator CLIbun run smartgrep [query]# Smart grepbun run monitor watch --overview# Live monitoring# Build semantic indexbun run smartgrep --index# Analyze your changesbun run smartgrep changes# Full impact analysisbun run smartgrep changes -c# Quick risk check# Work with packagescd src/packages/smartgrepbun run build# Build for distributionbun run build:binary# Create standalone binary

MCP Tools Available

📄 License

🙏 Acknowledgments

📚 Documentation

🎆 What's New

v4.0 - Git Impact Analysis & Custom Groups

v3.0 - Smart Grep Revolution

v2.3 - Incremental Indexing