agentcortex 1.0.4

Semantic infrastructure for AI coding agents

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

Command	Purpose
cortex init	Create .cortex/cortex.toml + cortexignore
cortex add cursor	Wire .cursor/mcp.json + rules
cortex add claude	Wire .mcp.json + .claude/rules/
cortex status	Daemon health, indexing progress, live counts
cortex dashboard	Open the web UI
cortex skills add <name>	Enable a skill (auto-syncs agent rules)
cortex reindex	Force a full rebuild
cortex clusters rebuild	Rebuild the project → app → feature tree
cortex start / cortex stop	Optional headless daemon (not needed when an editor MCP is connected)

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.