Files
agency-agents/integrations
Laurent Wandrebeck 90ae2b27d1 Add Mistral Vibe support for Agency agents (#658)
* Add Mistral Vibe support for Agency agents

- Add Mistral Vibe entry to tools.json with proper configuration
  (id, label, kebab, format, installKind, dest, detection, version)
- Implement convert_vibe() function in convert.sh for Mistral Vibe's format
  - Generates TOML agent configuration files (~/.vibe/agents/<slug>.toml)
  - Generates markdown prompt files (~/.vibe/prompts/<slug>.md)
  - Each agent gets agent_type and system_prompt_id (no hardcoded active_model)
- Add install_vibe() function in install.sh with full feature support
  - Copies both agent TOML and prompt MD files
  - Supports division/agent filtering and environment variable overrides
  - Uses VIBE_HOME environment variable for custom install paths
- Add Mistral Vibe detection and tool labeling
- Add Mistral Vibe to all necessary case statements and arrays
- Update README.md to document Mistral Vibe support
- All changes validated with scripts/check-tools.sh

Mistral Vibe uses a two-file approach per agent:
- ~/.vibe/agents/<slug>.toml for agent configuration
- ~/.vibe/prompts/<slug>.md for system prompts

Users can specify active_model in their agent TOML files or rely on their
Vibe configuration default model.

Usage: ./scripts/install.sh --tool vibe [--division X] [--agent Y]

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>

* Address PR #658 review feedback: add .gitignore, README, and fix icon

- Add integrations/vibe/README.md documenting the Mistral Vibe integration
- Update .gitignore to ignore integrations/vibe/agents/ and prompts/
- Update convert.sh usage() to include vibe in the tool list
- Fix tools.json: change vibe icon from 'mistral' to null (no mistral.svg)
- Bonus: update vibe accent color from #FF69B4 to #FA520F (Mistral brand orange)

Generated by Mistral Vibe.
Co-Authored-By: Mistral Vibe <vibe@mistral.ai>

---------

Co-authored-by: Mistral Vibe <vibe@mistral.ai>
2026-07-05 04:21:50 -05:00
..

🔌 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
  • AntigravitySKILL.md per agent in antigravity/
  • Gemini CLI.md agent files in gemini-cli/agents/
  • OpenCode.md agent files in opencode/
  • OpenClawSOUL.md + AGENTS.md + IDENTITY.md workspaces
  • Cursor.mdc rule files in cursor/
  • AiderCONVENTIONS.md in aider/
  • Windsurf.windsurfrules in windsurf/
  • Kimi Code — YAML agent specs in kimi/
  • Qwen Code — project-scoped .md SubAgents in .qwen/agents/
  • Codex.toml custom agents in codex/
  • Osaurus -- SKILL.md skills generated in osaurus/
  • Hermes -- lazy-router plugin generated in hermes/

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
./scripts/install.sh --tool codex
./scripts/install.sh --tool osaurus
./scripts/install.sh --tool hermes

# 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 qwen

If you install OpenClaw and the gateway is already running, restart it after installation:

openclaw gateway restart

For 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:

./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 Gemini CLI subagents. Subagents are installed to ~/.gemini/agents/. Because the agent files 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.


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.

./scripts/convert.sh --tool kimi
./scripts/install.sh --tool kimi

Usage

After installation, use an agent with the --agent-file flag:

kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml

Or in a specific project:

cd /your/project
kimi --agent-file ~/.config/kimi/agents/frontend-developer/agent.yaml \
     --work-dir /your/project

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

./scripts/convert.sh --tool qwen

Then install them from your project root:

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

See qwen/README.md for details.


Codex

Each agent is converted into a standalone Codex custom agent TOML file and installed to ~/.codex/agents/.

Because Codex uses generated TOML files rather than the source Markdown directly, run the converter before installing from a fresh clone:

./scripts/convert.sh --tool codex
./scripts/install.sh --tool codex

See codex/README.md for details.