---
paths: ['**/*']
description: Nexus-agents integration basics — MCP server config, env vars, common commands
---

# Nexus-Agents Integration

This project uses [nexus-agents](https://github.com/williamzujkowski/nexus-agents) v2.3.0 for multi-agent orchestration.

## MCP Tools Available

When running with MCP server mode, these tools are available:

| Tool                | Description                                       |
| ------------------- | ------------------------------------------------- |
| `orchestrate`       | Task orchestration with Orchestrator coordination |
| `create_expert`     | Dynamic expert agent creation                     |
| `run_workflow`      | Execute workflow templates                        |
| `delegate_to_model` | Route task to optimal model                       |
| `list_experts`      | List available expert types (discoverability)     |
| `list_workflows`    | List available workflow templates                 |

## Quick Commands

```bash
# Orchestrate a task with specialized experts
nexus-agents orchestrate "Implement feature X with tests"

# List available experts
nexus-agents expert list

# Run a workflow
nexus-agents workflow list
nexus-agents workflow run code-review --input='{"url": "..."}'

# Check system health
nexus-agents doctor

# Generate config
nexus-agents config init
```

## Usage Examples

**Orchestrate a code review:**

```
Use nexus-agents to review this PR: https://github.com/owner/repo/pull/123
```

**Create a specialized expert:**

```
Create a security expert to audit this codebase for vulnerabilities
```

**Run a workflow:**

```
Run the code-review workflow with the current changes
```

## Configuration

- Config file: `./nexus-agents.yaml`
- Generate config: `nexus-agents config init`
- Check health: `nexus-agents doctor`

---

_Generated by nexus-agents setup v2.3.0_
