🔌 Integrations

This directory contains The Agency integrations and converted formats for supported agentic coding tools.

Supported Tools

• Claude Code — .md agents, use the repo directly
• GitHub Copilot — .md agents, use the repo directly
• Antigravity — SKILL.md per agent in antigravity/
• Gemini CLI — extension + SKILL.md files in gemini-cli/
• OpenCode — .md agent files in opencode/
• OpenClaw — SOUL.md + AGENTS.md + IDENTITY.md workspaces
• Cursor — .mdc rule files in cursor/
• Aider — CONVENTIONS.md in aider/
• Windsurf — .windsurfrules in windsurf/

Quick Install

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

# Install a specific home-scoped tool
./scripts/install.sh --tool antigravity
./scripts/install.sh --tool copilot
./scripts/install.sh --tool openclaw
./scripts/install.sh --tool claude-code

# Gemini CLI needs generated integration files on a fresh clone
./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cli

For project-scoped tools such as OpenCode, Cursor, Aider, and Windsurf, run the installer from your target project root as shown in the tool-specific sections below.

Regenerating Integration Files

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

./scripts/convert.sh

---

Claude Code

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

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

See claude-code/README.md for details.

---

GitHub Copilot

The Agency also works natively with GitHub Copilot. Agents can be copied directly into ~/.github/agents/ and ~/.copilot/agents/ without conversion.

./scripts/install.sh --tool copilot

See github-copilot/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.

./scripts/install.sh --tool antigravity

See 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/. Because the Gemini manifest and skill folders are generated artifacts, run ./scripts/convert.sh --tool gemini-cli before installing from a fresh clone.

./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cli

See gemini-cli/README.md for details.

---

OpenCode

Each agent becomes a project-scoped .md file in .opencode/agents/.

cd /your/project && /path/to/agency-agents/scripts/install.sh --tool opencode

See opencode/README.md for details.

---

OpenClaw

Each agent becomes an OpenClaw workspace containing SOUL.md, AGENTS.md, and IDENTITY.md.

Before installing, generate the OpenClaw workspaces:

./scripts/convert.sh --tool openclaw

Then install them:

./scripts/install.sh --tool openclaw

See openclaw/README.md for details.

---

Cursor

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

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

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

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

See aider/README.md for details.

---

Windsurf

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

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

See windsurf/README.md for details.