🔌 Integrations
This directory contains The Agency integrations and converted formats for supported agentic coding tools.
Supported Tools
- [Claude Code](#claude-code) —
.mdagents, use the repo directly - [GitHub Copilot](#github-copilot) —
.mdagents, use the repo directly - [Antigravity](#antigravity) —
SKILL.mdper agent inantigravity/ - [Gemini CLI](#gemini-cli) — extension +
SKILL.mdfiles ingemini-cli/ - [OpenCode](#opencode) —
.mdagent files inopencode/ - [OpenClaw](#openclaw) —
SOUL.md+AGENTS.md+IDENTITY.mdworkspaces - [Cursor](#cursor) —
.mdcrule files incursor/ - [Aider](#aider) —
CONVENTIONS.mdinaider/ - [Windsurf](#windsurf) —
.windsurfrulesinwindsurf/ - [Kimi Code](#kimi-code) — YAML agent specs in
kimi/ - [Qwen Code](#qwen-code) — project-scoped
.mdSubAgents in.qwen/agents/
Quick Install
bash# 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
# Qwen Code also needs generated SubAgent files on a fresh clone
./scripts/convert.sh --tool qwen
./scripts/install.sh --tool qwenIf you install OpenClaw and the gateway is already running, restart it after installation:
bashopenclaw gateway restartFor project-scoped tools such as OpenCode, Cursor, Aider, Windsurf, and Qwen Code, 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:
bash./scripts/convert.shClaude Code
The Agency was originally designed for Claude Code. Agents work natively without conversion.
bashcp -r <category>/*.md ~/.claude/agents/
# or install everything at once:
./scripts/install.sh --tool claude-codeSee 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.
bash./scripts/install.sh --tool copilotSee 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.
bash./scripts/install.sh --tool antigravitySee 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.
bash./scripts/convert.sh --tool gemini-cli
./scripts/install.sh --tool gemini-cliSee gemini-cli/README.md for details.
OpenCode
Each agent becomes a project-scoped .md file in .opencode/agents/.
bashcd /your/project && /path/to/agency-agents/scripts/install.sh --tool opencodeSee 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:
bash./scripts/convert.sh --tool openclawThen install them:
bash./scripts/install.sh --tool openclawSee openclaw/README.md for details.
Cursor
Each agent becomes a .mdc rule file. Rules are project-scoped — run the installer from your project root.
bashcd /your/project && /path/to/agency-agents/scripts/install.sh --tool cursorSee 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.
bashcd /your/project && /path/to/agency-agents/scripts/install.sh --tool aiderSee aider/README.md for details.
Windsurf
All agents are consolidated into a single .windsurfrules file for your project root.
bashcd /your/project && /path/to/agency-agents/scripts/install.sh --tool windsurfSee windsurf/README.md for details.
Kimi Code
Each agent is converted to a Kimi Code CLI agent specification (YAML format with separate system prompt files). Agents are installed to ~/.config/kimi/agents/.
Because the Kimi agent files are generated from the source Markdown, run ./scripts/convert.sh --tool kimi before installing from a fresh clone.
bash./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimiUsage
After installation, use an agent with the --agent-file flag:
bashkimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yamlOr in a specific project:
bashcd /your/project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
--work-dir /your/projectSee kimi/README.md for details.
Qwen Code
Each agent becomes a project-scoped .md SubAgent file in .qwen/agents/.
From a fresh clone, generate the Qwen files first:
bash./scripts/convert.sh --tool qwenThen install them from your project root:
bashcd /your/project && /path/to/agency-agents/scripts/install.sh --tool qwenSee qwen/README.md for details.