agentcortex

Semantic infrastructure for AI coding agents — index a project once, serve it to Cursor / Claude Code over MCP, stop letting your agent re-grep the repo every turn.

pip install agentcortex

Requires Python 3.11+. Works on macOS, Linux, and Windows.

Quick start

In your project (not inside the install directory):

cd /path/to/your-app
cortex init                  # write .cortex/cortex.toml + ignore
cortex add cursor            # or: cortex add claude

Open your editor. The MCP integration auto-spawns cortex serve, which brings up the live dashboard at http://localhost:7070. No background daemon required.

For headless / terminal-only use you can still run cortex start to keep the indexer alive without an editor.

What's in the box

• 10 framework skills — Django, Next.js, FastAPI, Flutter, React, TypeScript, Celery, Go, C#, Python
• 74 MCP tools — find_symbol, find_symbol_usages, trace_symbol_calls, find_dependencies, search_codebase, get_code_issues, find_clusters, check_impact, get_pattern, plus every skill's framework-specific tools (list_django_urls, trace_request_flow, list_flutter_widgets, list_celery_tasks, …)
• Code graph — calls, imports, contains, exposes, renders, inherits — across files and frameworks (URL → view → serializer → model for Django; route → page → component for Next.js; widget → state → API for Flutter)
• Hierarchical cluster engine — project → app → feature, auto-seeded from execution roots
• Redundancy engine — check_impact + get_pattern MCP tools and a sharpened agent dedupe gate so the agent extends your code instead of duplicating it
• Live dashboard — file tree, graph explorer, Clusters tab, Feed, Logs, MCP tool runner

All data is local under .cortex/ in each repo. Nothing leaves your machine.

Common commands

Run cortex --help for the full list.

Documentation

• Source code and full README: https://github.com/zohaib3249/cortex
• Changelog — release notes for every version
• Editor integrations

License

Cortex Personal Use License — personal and non-commercial use only. See LICENSE on GitHub.

Commercial use (company, client work, SaaS, resale) requires a separate agreement.