# 🔌 Integrations

This directory contains The Agency's 61 AI agents converted into formats
compatible with popular agentic coding tools.

## Supported Tools

| Tool | Format | Directory |
| ---- | ------ | --------- |
| [Claude Code](#claude-code) | `.md` with frontmatter | use repo directly |
| [Antigravity](#antigravity) | `SKILL.md` per agent | `antigravity/` |
| [Gemini CLI](#gemini-cli) | Extension + `SKILL.md` | `gemini-cli/` |
| [OpenCode](#opencode) | `.md` agent files | `opencode/` |
| [Cursor](#cursor) | `.mdc` rules | `cursor/` |
| [Aider](#aider) | `CONVENTIONS.md` | `aider/` |
| [Windsurf](#windsurf) | `.windsurfrules` | `windsurf/` |

## Quick Install

```bash
# Install for all detected tools automatically
./scripts/install.sh

# Install for a specific tool
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool gemini-cli
./scripts/install.sh --tool cursor
./scripts/install.sh --tool aider
./scripts/install.sh --tool windsurf
./scripts/install.sh --tool claude-code
```

## Regenerating Integration Files

If you add or modify agents, regenerate all integration files:

```bash
./scripts/convert.sh
```

---

## Claude Code

The Agency was originally designed for Claude Code. Agents work natively
without conversion.

```bash
cp -r <category>/*.md ~/.claude/agents/
# or install everything at once:
./scripts/install.sh --tool claude-code
```

See [claude-code/README.md](claude-code/README.md) for details.

---

## Antigravity

Skills are installed to `~/.gemini/antigravity/skills/`. Each agent becomes
a separate skill prefixed with `agency-` to avoid naming conflicts.

```bash
./scripts/install.sh --tool antigravity
```

See [antigravity/README.md](antigravity/README.md) for details.

---

## Gemini CLI

Agents are packaged as a Gemini CLI extension with individual skill files.
The extension is installed to `~/.gemini/extensions/agency-agents/`.

```bash
./scripts/install.sh --tool gemini-cli
```

See [gemini-cli/README.md](gemini-cli/README.md) for details.

---

## Cursor

Each agent becomes a `.mdc` rule file. Rules are project-scoped — run the
installer from your project root.

```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool cursor
```

See [cursor/README.md](cursor/README.md) for details.

---

## Aider

All agents are consolidated into a single `CONVENTIONS.md` file that Aider
reads automatically when present in your project root.

```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool aider
```

See [aider/README.md](aider/README.md) for details.

---

## Windsurf

All agents are consolidated into a single `.windsurfrules` file for your
project root.

```bash
cd /your/project && /path/to/agency-agents/scripts/install.sh --tool windsurf
```

See [windsurf/README.md](windsurf/README.md) for details.