Skip to main content

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 toolsfind_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 enginecheck_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


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.

Download files

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

Source Distribution

agentcortex-1.0.4.tar.gz (306.1 kB view details)

Uploaded Source

Built Distribution

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

agentcortex-1.0.4-py3-none-any.whl (381.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for agentcortex-1.0.4.tar.gz
Algorithm Hash digest
SHA256 2dcdb029db360277a73ec97be3b8921dc4465601fb0c482655f6fbe17b0e56b9
MD5 68b528595e110dcdf15cc98440ad8f8b
BLAKE2b-256 dff6f237da80de368b8eec25d3f854e2213204326afe663a4daaddbcd6feb1ea

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentcortex-1.0.4.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-1.0.4-py3-none-any.whl.

File metadata

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

File hashes

Hashes for agentcortex-1.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 4a9b9035efc003ad0dca9f5fe42a203b96503e49ad2f96b3d04c121d8a95ad08
MD5 ee6564426f4c5ebff3edab66b214e200
BLAKE2b-256 047ec5b6bbe692cf6831241a74c3dec90ae6fad4cc503ddb880374273c785375

See more details on using hashes here.

Provenance

The following attestation bundles were made for agentcortex-1.0.4-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.

Release history Release notifications | RSS feed

This release

1.0.4 This release

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.0.9

2 files

0.0.8

2 files

0.0.7

2 files

0.0.6

2 files

0.0.5

2 files

0.0.4

2 files

0.0.3

2 files

0.0.2

2 files

0.0.1

2 files

Supported by

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