AIDOCS

<p align="center">
  <img src="docs/assets/cn-logo.svg" alt="CodeNexus" width="120">
</p>

<h1 align="center">AIDOCS</h1>

<p align="center">
  <strong>The orchestration layer for AI coding agents — persistent memory, conductor, dashboard, and multi-agent workflows.</strong>
</p>

<p align="center">
  <img src="https://img.shields.io/github/v/release/cristian1991/AIDOCS?label=version&color=blue" alt="version">
  <img src="https://img.shields.io/badge/license-Apache%202.0-green" alt="license">
  <img src="https://img.shields.io/badge/python-3.11%2B-yellow" alt="python">
  <img src="https://img.shields.io/badge/tests-1363%20passing-brightgreen" alt="tests">
</p>

<p align="center">
  A <a href="https://codenexus.cloud">CodeNexus</a> project
</p>

<h3 align="center">Supported Agents</h3>

<p align="center">
<table align="center">
<tr>
<td align="center" valign="top" width="200">
  <img src="https://img.shields.io/badge/Claude_Code-CC5500?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude Code"><br>
  <sub>Hooks + MCP + Dashboard</sub><br>
  <sub><strong>Full orchestration</strong></sub>
</td>
<td align="center" valign="top" width="200">
  <img src="https://img.shields.io/badge/OpenCode-000000?style=for-the-badge" alt="OpenCode"><br>
  <sub>Plugin + MCP + Serve mode</sub><br>
  <sub><strong>Full orchestration</strong></sub>
</td>
<td align="center" valign="top" width="200">
  <img src="https://img.shields.io/badge/Codex-10A37F?style=for-the-badge&logo=openai&logoColor=white" alt="Codex"><br>
  <sub>MCP + CLI conductor</sub><br>
  <sub><strong>Full orchestration</strong></sub>
</td>
<td align="center" valign="top" width="200">
  <img src="https://img.shields.io/badge/Any_MCP_Host-4A90D9?style=for-the-badge" alt="MCP"><br>
  <sub>Via <code>.mcp.json</code></sub><br>
  <sub>Tools + memory</sub>
</td>
</tr>
</table>
</p>

---

## What It Does

AIDOCS is the orchestration layer that makes AI coding agents smarter without replacing them. It works with Claude Code, Codex, OpenCode, Cursor, and any MCP-compatible host.

- **Persistent memory** — agents resume work instead of rediscovering your repo every time
- **Conductor** — long-lived orchestrator that dispatches tasks, manages lane agents, resolves conflicts
- **Dashboard** — desktop app to monitor, control, and configure everything (no terminal needed)
- **Indexed retrieval** — code search by symbol, meaning, or relationship instead of blind grep
- **Security gates** — heuristic judge, output guard, tool policies, RBAC
- **Multi-agent routing** — assign the right model to the right task (Claude for code, GPT for refactoring, Gemini for docs)
- **Zero migration** — works as an overlay on your existing tools, no framework lock-in

### Product Surfaces

- **MCP Runtime** — 120+ tools: indexing, retrieval, orchestration, conductor, security gates
- **Dashboard** — Tauri desktop app: conductor chat, monitoring, settings, task routing, setup wizard
- **CLI** — `aidocs setup`, `doctor`, `init`, `status`, `sync`, `benchmark`
- **Host Adapters** — Claude Code hooks, OpenCode plugin, Codex CLI, generic MCP

### Key Capabilities

- **Conductor** — long-lived agent that manages tasks, dispatches lane agents, routes models per task type
- **Dashboard control** — start/stop/pause agents, send tasks, see live output, no terminal needed
- **Persistent memory** — routed session startup, journal, plans, handoffs across conversations
- **Semantic search** — embedding-based code search (local model, no API) + symbol/text search
- **Security gates** — heuristic judge, output guard, tool policies, RBAC, lane isolation
- **Task routing** — assign Claude for implementation, GPT for refactoring, Gemini for docs
- **Conductor comms** — agents ask conductor questions, auto-resolve scope conflicts, pause/resume lanes
- **Edit history** — diff-based rollback with agent/lane attribution

## Quick Start

### Windows

Download `AIDOCS-Setup.exe` from [Releases](https://github.com/cristian1991/AIDOCS/releases). Includes Python, setup wizard, and dashboard. Double-click and go.

### Linux/macOS

One command, installs Python + AIDOCS:
```bash
curl -fsSL https://raw.githubusercontent.com/cristian1991/AIDOCS/main/core/scripts/install.sh | bash
```

### Already have Python 3.11+?

```bash
pip install aidocs-mcp        # install the package
aidocs setup                  # configures everything: MCP, hooks, project init
aidocs doctor                 # verify the install
```

### Then

Open your project in your IDE and type `/aidocs`. That's it.
Open your project in any supported IDE and type `/aidocs` to activate managed mode.

## Project Layout

```
aidocs.toml                  # Runtime configuration (static definitions)
action_tokens/               # Prompt-classification language files (en, it, ...)

core/
  .commands/                  # Slash commands (/aidocs, /reingest, /archive, etc.)
  hooks/                      # Hook definitions (hooks.json)
  plugins/                    # OpenC

... (truncated)