Overview
CodeAlive’s semantic code search goes beyond keyword matching — it understands the meaning and intent behind your queries. Ask for “authentication flow” and find JWT validation, OAuth callbacks, and session management code, even if none of those files contain the word “authentication.” This is powered by CodeAlive’s GraphRAG indexing, which maps relationships between code components, dependencies, and architectural patterns across your entire codebase.How It Works
1
Index
CodeAlive indexes your repositories, building a knowledge graph of code relationships, function signatures, data flows, and architectural patterns.
2
Query
You ask a natural-language question. CodeAlive translates it into a semantic search across the knowledge graph, finding code that matches by meaning — not just text.
3
Results
You get file paths, line numbers, and code snippets ranked by relevance. Your AI agent can then read the actual files for full context.
Choose a search tool
- Semantic search
- Grep search
Use
semantic_search when you know the behavior or concept but not the exact identifier.Example Queries
Authentication & Security
Authentication & Security
- “How is JWT token validation implemented?”
- “Find OAuth callback handlers”
- “Show me all authorization middleware”
- “Where are API keys validated?”
Error Handling
Error Handling
- “How does the system handle database connection failures?”
- “Find retry logic across services”
- “Show me error boundary implementations”
- “Where are 500 errors caught and reported?”
Architecture Patterns
Architecture Patterns
- “Find all event-driven communication between services”
- “Show me the repository pattern implementations”
- “How is dependency injection configured?”
- “Find all middleware in the request pipeline”
API & Data
API & Data
- “List all REST API endpoints”
- “Find database migration files”
- “Show me GraphQL resolver implementations”
- “Where is caching implemented?”
Access Methods
- MCP Tool
- REST API
- Skill CLI
The
semantic_search tool is available through any CodeAlive-connected agent:Your AI agent calls this tool automatically when you ask questions about your codebase.
Best Practices
Be Specific
Use domain-specific terms: “JWT validation” is better than “security check”
Pick the right tool
Use semantic search for concepts and grep search for exact text or regular expressions
Scope Your Search
Target specific repositories or workspaces to get more relevant results
Iterate
Refine your query based on initial results — each search is fast and cheap
Related Resources
Codebase Chat
Get synthesized answers instead of raw search results
Multi-Repository
Search across multiple repositories and workspaces
MCP Integration
Connect search to your AI assistant
API Reference
Semantic search endpoint documentation