Metadata-Version: 2.4
Name: agentcortex
Version: 1.0.1
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
Dynamic: license-file

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

```bash
pip install agentcortex
```

Requires **Python 3.11+**.

---

## Quick start

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

```bash
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):

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

---

## 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 requires a separate agreement with the maintainers.
