Agent integrations

gaal ships with a built-in registry of supported coding agents plus a vendor-neutral generic fallback. For each one, the registry knows where skills live and where to upsert MCP server entries. That’s what makes agents: ["*"] in your gaal.yaml work.

Supported agents

Claude Code

Cursor

Codex

GitHub Copilot

Windsurf

Continue

Gemini CLI

Goose

Cline

Roo

Augment

OpenCode

OpenHands

Trae

Kilo

Kiro CLI

Amp

Zencoder

Antigravity

Warp

Generic

Quick lookup

Agent	Project skills	Global skills	MCP config
Claude Code	`.claude/skills`	`~/.claude/skills`	`~/.claude.json`
Cursor	`.agents/skills` (generic)	`~/.cursor/skills`	`~/.cursor/mcp.json`
Codex	`.agents/skills` (generic)	`~/.codex/skills`	`~/.codex/config.toml`
GitHub Copilot	`.github/skills`	`~/.copilot/skills`	`~/.vscode/settings.json`
Windsurf	`.windsurf/skills`	`~/.codeium/windsurf/skills`	`~/.codeium/windsurf/mcp_settings.json`
Continue	`.continue/skills`	`~/.continue/skills`	`~/.continue/config.json`
Gemini CLI	`.agents/skills` (generic)	`~/.gemini/skills`	`~/.gemini/settings.json`
Goose	`.goose/skills`	`~/.config/goose/skills`	`~/.config/goose/config.yaml`
Cline	`.agents/skills` (generic)	`~/.agents/skills` (generic)	`~/.vscode/settings.json`
Roo	`.roo/skills`	`~/.roo/skills`	`~/.vscode/settings.json`
Augment	`.augment/skills`	`~/.augment/skills`	`~/.augment/settings.json`
OpenCode	`.agents/skills` (generic)	`~/.config/opencode/skills`	`~/.config/opencode/config.json`
OpenHands	`.openhands/skills`	`~/.openhands/skills`	`~/.openhands/config.json`
Trae	`.trae/skills`	`~/.trae/skills`	`~/.trae/mcp.json`
Kilo	`.kilocode/skills`	`~/.kilocode/skills`	`~/.kilocode/mcp.json`
Kiro CLI	`.kiro/skills`	`~/.kiro/skills`	`~/.kiro/settings/mcp.json`
Amp	`.agents/skills` (generic)	`~/.config/agents/skills`	`~/.config/amp/settings.json`
Zencoder	`.zencoder/skills`	`~/.zencoder/skills`	`~/.zencoder/mcp.json`
Antigravity	`.agents/skills` (generic)	`~/.gemini/antigravity/skills`	, (no MCP)
Warp	`.agents/skills` (generic)	`~/.agents/skills` (generic)	`~/.warp/launch_configurations/mcp.json`
Generic	`.agents/skills`	`~/.agents/skills`	, (no MCP)

(generic) means the agent shares the vendor-neutral .agents/skills or ~/.agents/skills directory rather than maintaining its own. See Concepts → Agents & renderers.

Listing what’s installed on this machine

gaal agents               # all registered agents
gaal agents --installed   # only those gaal detects on this machine
gaal agents claude-code   # detailed view for one agent
gaal agents -o json       # machine-readable

Adding a new agent

Use Custom agents to teach gaal about an agent it doesn’t ship with yet. If the agent is publicly available, please open a PR at github.com/getgaal/gaal so everyone gets it.

Get started

Concepts

Configure

Workflows