Complete guide to using CodePathfinder for semantic code search and indexing.
CodePathfinder helps you index and semantically search your GitHub repositories. Once indexed, you can use Claude Desktop or the API to search your codebase using natural language.
CodePathfinder is a semantic code search platform that:
CodePathfinder provides native syntax analysis and intelligent parsing for a wide range of programming languages and file formats.
Note: All supported file types get intelligent chunking and vector embeddings for semantic search. Programming languages additionally receive syntax-aware analysis for functions, classes, and symbols.
Here's how teams are using CodePathfinder to supercharge their development workflows.
New team members can ask natural language questions about unfamiliar codebases:
Example queries:
Find code by describing what it does, not by guessing variable names:
Example queries:
Get insights about your codebase structure and patterns:
Example queries:
Identify potential security concerns and compliance issues:
Example queries:
Identify gaps in documentation and generate content:
Example queries:
Give your AI agents deep understanding of your codebase:
Use cases:
Projects are the core of CodePathfinder. Each project represents a GitHub repository that you want to index and search.
| Field | Description |
|---|---|
| Name | A descriptive name for your project |
| Repository URL | Full HTTPS URL to your GitHub repository |
| GitHub Token | Personal Access Token for private repos |
| Branch | Specific branch to index (optional) |
Hint: For private repositories, you'll need a GitHub Personal Access Token with
repo scope.
CodePathfinder provides a REST API and MCP (Model Context Protocol) integration for programmatic access to your indexed code. MCP is supported by Claude, ChatGPT, Google Gemini, and other AI agents.
Connect via OAuth — no API key needed:
CodePathfinder, URL: https://codepathfinder.com/mcpAlternatively, use an API key with the MCP bridge in claude_desktop_config.json:
{
"mcpServers": {
"codepathfinder": {
"command": "npx",
"args": ["-y", "@grabowskit/mcp-bridge"],
"env": {
"CODEPATHFINDER_API_KEY": "YOUR_API_KEY",
"CODEPATHFINDER_API_ENDPOINT": "https://codepathfinder.com/mcp/"
}
}
}
}
ChatGPT supports MCP through Developer Mode (available for Pro, Plus, Business, and Enterprise accounts):
URL: https://codepathfinder.com/mcp/ Authorization: Bearer YOUR_API_KEY
Gemini supports MCP through the Gemini CLI and Gemini Code Assist:
Gemini CLI Configuration
Add to your Gemini CLI config:
{
"mcpServers": {
"codepathfinder": {
"command": "npx",
"args": ["-y", "@grabowskit/mcp-bridge"],
"env": {
"CODEPATHFINDER_API_KEY": "YOUR_API_KEY",
"CODEPATHFINDER_API_ENDPOINT": "https://codepathfinder.com/mcp/"
}
}
}
}
For custom integrations or other AI agents, use the MCP endpoint directly (MCP 2025-06-18 Streamable HTTP):
POST https://codepathfinder.com/mcp/
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "semantic_code_search",
"arguments": {
"query": "authentication middleware"
}
}
}
semantic_code_search - Natural language code searchmap_symbols_by_query - Find functions, classes, methodssymbol_analysis - Analyze definitions and usagesread_file_from_chunks - Read complete filesdocument_symbols - Find undocumented codesize - Get project statisticsgithub_create_issue - Create issues with title, body, and labelsgithub_add_comment - Add comments to issues or PRsgithub_create_pull_request - Create pull requestsgithub_create_branch - Create new branchesgithub_list_branches - List repository branchesgithub_get_repo_info - Get repository metadatagithub_get_labels - Get repository labelsskills_list, skills_get, skills_search - Browse and find AI agent skillsskills_sync, skills_import, skills_activate - Manage and sync skillsjob_manage - Start, stop, or reset indexing jobsjob_status - Get job status informationCodePathfinder includes a built-in AI Chat interface powered by LibreChat, available at /chat/ after signing in.
The Chat interface connects to your indexed projects automatically. Just ask questions about your code!
Common issues and how to resolve them.
Click Stop, check the Console for errors, and try running again. Enable "Clean Index" if the problem persists.
Ensure your GitHub token has repo scope
and hasn't expired.
Verify the project is indexed (status should be "Completed"). Check that the project visibility toggle is ON.
Verify your API key is correct and hasn't been revoked. Ensure the MCP bridge config has the correct endpoint URL.
Check if the file type is supported (see Supported Languages section). Very large files may be skipped. Binary files and common directories like node_modules are excluded by default.
Join the Private Beta and unlock the power of semantic code search.
Join Private Beta 🚀