agentcortex 1.0.0

Semantic infrastructure for AI coding agents

agentcortex

Semantic infrastructure for AI coding agents — symbol index, call graph, framework skills, MCP tools, and a live dashboard for Cursor, Claude Code, and other editors.

Install the package, then use the cortex CLI in any project.

pip install agentcortex

Requires Python 3.11+.

---

Quick start

In your project (not inside the agentcortex install directory):

cd /path/to/your-app
cortex init                  # name, port, skills, repo path
cortex add cursor            # or: cortex add claude

When your editor connects Cortex MCP, it runs cortex serve, which starts MCP tools and the dashboard at http://127.0.0.1:7070 (port configurable in .cortex/cortex.toml).

Optional background indexer (watches files on save):

cortex start

---

What you get

Feature	Description
Symbol index	Python, JavaScript, TypeScript via tree-sitter
MCP tools	find_symbol, find_symbol_usages, trace_symbol_calls, get_file_metadata, and more
Framework skills	Optional packs: python, django, react, typescript, nextjs, celery
Dashboard	Graph explorer, issues, operations panel
Agent wiring	cortex add cursor / cortex add claude installs MCP config and agent rules

All project data stays under .cortex/ in each repo you index. Nothing is sent to a cloud service by default.

---

Common commands

Command	Description
cortex init	Create .cortex/cortex.toml and .cortex/cortexignore
cortex add cursor	Wire .cursor/mcp.json + rules
cortex add claude	Wire .mcp.json + .claude/rules/
cortex start	Background daemon (indexer + HTTP API)
cortex serve	MCP over stdio (used by editors)
cortex skills add django python	Enable skills
cortex dashboard	Open the web UI
cortex reindex	Re-scan the repository
cortex status	Daemon health and stats

Run cortex --help for the full list.

---

Skills

Enable with cortex skills add <name>:

Skill	Examples
python	get_function_signature, get_python_issues
django	trace_request_flow, list_django_urls
react	list_react_components, trace_component_tree
typescript	get_typescript_issues, list_typescript_exports
nextjs	get_route_tree, find_server_actions
celery	list_celery_tasks

---

Documentation

Full docs, source code, and contributing guidelines:

https://github.com/zohaib3249/cortex

• Getting started
• Editor integrations
• Changelog — release notes for every version

---

License

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

Commercial use requires a separate agreement with the maintainers.