Skip to main content

Semantic infrastructure for AI coding agents

Project description

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


License

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

Commercial use requires a separate agreement with the maintainers.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

agentcortex-0.0.3.tar.gz (207.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

agentcortex-0.0.3-py3-none-any.whl (267.2 kB view details)

Uploaded Python 3

File details

Details for the file agentcortex-0.0.3.tar.gz.

File metadata

  • Download URL: agentcortex-0.0.3.tar.gz
  • Upload date:
  • Size: 207.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentcortex-0.0.3.tar.gz
Algorithm Hash digest
SHA256 bbdb424e9e5bdddc81d5f200b7d4e1627e21d7670218846a75ccdff260b6f5a5
MD5 3136fdd81d9b7e03ccc12636aaa1edd3
BLAKE2b-256 826fcd8d0895542bdca79823b598a9fc50658c57a7b47333a59a6f3f605d42ec

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentcortex-0.0.3.tar.gz:

Publisher: release.yml on zohaib3249/cortex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file agentcortex-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: agentcortex-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 267.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for agentcortex-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 b0d95ab56ed4fa97fb1de77fd5d4171d363b80978b41fe1f3aa6de16c9e7b475
MD5 aa096ef3009299757de5e72d55afac14
BLAKE2b-256 d6f8b9c0cfeeb5e05f36f0233c21ca556e08a011d3a8fc16fcb8941cbc856c0f

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentcortex-0.0.3-py3-none-any.whl:

Publisher: release.yml on zohaib3249/cortex

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page