Metadata-Version: 2.4
Name: agentcortex
Version: 1.0.4
Summary: Semantic infrastructure for AI coding agents
License: Cortex Personal Use License — see LICENSE (personal use only, no commercial use)
Project-URL: Homepage, https://github.com/zohaib3249/cortex
Project-URL: Repository, https://github.com/zohaib3249/cortex
Project-URL: Changelog, https://github.com/zohaib3249/cortex/blob/master/CHANGELOG.md
Project-URL: Issues, https://github.com/zohaib3249/cortex/issues
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: watchdog>=4.0
Requires-Dist: tomllib; python_version < "3.11"
Requires-Dist: mcp>=1.0
Requires-Dist: fastapi>=0.111
Requires-Dist: uvicorn[standard]>=0.29
Requires-Dist: websockets>=12.0
Requires-Dist: kuzu>=0.5
Requires-Dist: chromadb>=0.5
Requires-Dist: tree-sitter>=0.23
Requires-Dist: tree-sitter-python>=0.23
Requires-Dist: tree-sitter-javascript>=0.23
Requires-Dist: tree-sitter-typescript>=0.23
Requires-Dist: click>=8.1
Requires-Dist: rich>=13.0
Requires-Dist: pydantic>=2.7
Requires-Dist: windows-curses>=2.3; sys_platform == "win32"
Dynamic: license-file

# 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.

```bash
pip install agentcortex
```

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

---

## Quick start

In your project (not inside the install directory):

```bash
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](https://github.com/zohaib3249/cortex/blob/master/CHANGELOG.md) — release notes for every version
- [Editor integrations](https://github.com/zohaib3249/cortex/tree/master/integrations)

---

## License

**Cortex Personal Use License** — personal and non-commercial use only. See [LICENSE](https://github.com/zohaib3249/cortex/blob/master/LICENSE) on GitHub.

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