CortexCode - AI Code Index

Lightweight code indexing for AI assistants. Use @cortexcode in Copilot Chat, run cortexcode wiki to generate documentation, or configure MCP to enable AI agents to understand your codebase.

Features

• CodeWiki — Generate AI-powered documentation sites with cortexcode wiki
• Copilot Chat Integration — Use @cortexcode in Copilot Chat to query your codebase
• MCP Server — AI agents can use CortexCode tools via Model Context Protocol
• Hover Tooltips — Hover over any symbol to see its definition
• Go to Definition — Ctrl+Click on any symbol to jump to its definition
• Auto-indexing — Automatically indexes your project on open
• Live Updates — Re-indexes when files change

Quick Start

# Install CortexCode CLI
pip install cortexcode

# Index your project
cortexcode index

# Generate CodeWiki documentation
cortexcode wiki --open

Commands

Terminal Commands

Copilot Chat Commands

In Copilot Chat, use these commands with @cortexcode:

MCP Configuration (Windsurf, Cursor, Claude Desktop)

Add to your MCP config:

{
  "mcpServers": {
    "cortexcode": {
      "command": "cortexcode",
      "args": ["mcp"]
    }
  }
}

Available MCP Tools (17 tools)

Search & Navigation | Tool | Description | Trigger Phrases | |------|-------------|-----------------| | cortexcode_search | Find symbols by name | "find", "search for", "where is" | | cortexcode_fuzzy_search | Fuzzy/approximate search | typos, partial names | | cortexcode_regex_search | Regex pattern search | "find all getters", "functions starting with" | | cortexcode_context | Get symbol implementation | "how does X work", "show me code" | | cortexcode_file_symbols | List symbols in a file | "what's in this file" | | cortexcode_call_graph | Trace callers/callees | "what uses this", "where is called" |

Analysis | Tool | Description | Trigger Phrases | |------|-------------|-----------------| | cortexcode_deadcode | Find unused code | "dead code", "not used" | | cortexcode_complexity | Complex functions | "complex code", "hard to maintain" | | cortexcode_impact | Change impact analysis | "what breaks if I change X" | | cortexcode_duplicates | Duplicate code detection | "copy-paste", "repeated code" | | cortexcode_circular_deps | Circular dependency detection | "import cycles", "circular" |

Security & Quality | Tool | Description | Trigger Phrases | |------|-------------|-----------------| | cortexcode_security_scan | Security vulnerability scan | "secrets", "SQL injection", "XSS" | | cortexcode_endpoints | API endpoint extraction | "routes", "APIs", "endpoints" | | cortexcode_api_docs | Auto-generate API docs | "documentation", "undocumented" |

Project Info | Tool | Description | Trigger Phrases | |------|-------------|-----------------| | cortexcode_stats | Project statistics | "project size", "how big" | | cortexcode_diff | Changed symbols | "what changed", "modified" | | cortexcode_file_deps | File dependencies | "depends on", "imports" |

Requirements

• VS Code 1.93+ / Windsurf / Cursor
• Python 3.10+
• CortexCode CLI (pip install cortexcode)

Extension Settings

• cortexcode.indexOnOpen — Automatically index project when opened (default: true)
• cortexcode.autoWatch — Auto-reindex on file changes (default: true)

For AI Agents

This extension exposes code intelligence capabilities. AI coding agents can:

• Find symbols by name across the entire codebase
• Get relevant context with call graph connectivity
• Analyze what would break if a symbol is changed
• Find potentially dead code
• Identify complex functions that need attention
• Trace file dependencies and imports

License

MIT