# gaal

## Docs

- [Amp](https://docs.getgaal.com/agents/amp.md): Sourcegraph's agentic coding tool.
- [Antigravity](https://docs.getgaal.com/agents/antigravity.md): Google's agentic IDE based on Gemini.
- [Augment](https://docs.getgaal.com/agents/augment.md): Augment Code AI agent.
- [Claude Code](https://docs.getgaal.com/agents/claude-code.md): Anthropic's terminal coding agent.
- [Cline](https://docs.getgaal.com/agents/cline.md): Open-source AI assistant for VS Code.
- [Codex](https://docs.getgaal.com/agents/codex.md): OpenAI Codex CLI coding agent.
- [Continue](https://docs.getgaal.com/agents/continue.md): Open-source coding assistant for VS Code and JetBrains.
- [Cursor](https://docs.getgaal.com/agents/cursor.md): AI-first code editor with native MCP support.
- [Gemini CLI](https://docs.getgaal.com/agents/gemini-cli.md): Google's terminal coding agent.
- [Generic](https://docs.getgaal.com/agents/generic.md): The vendor-neutral fallback for agents that share .agents/skills.
- [GitHub Copilot](https://docs.getgaal.com/agents/github-copilot.md): Copilot in VS Code, with MCP via VS Code settings.
- [Goose](https://docs.getgaal.com/agents/goose.md): Block's open-source AI coding agent.
- [Kilo](https://docs.getgaal.com/agents/kilo.md): Kilo Code AI assistant.
- [Kiro CLI](https://docs.getgaal.com/agents/kiro-cli.md): AWS Kiro terminal coding agent.
- [OpenCode](https://docs.getgaal.com/agents/opencode.md): Open-source terminal coding agent.
- [OpenHands](https://docs.getgaal.com/agents/openhands.md): Open-source autonomous AI software engineer.
- [Agent integrations](https://docs.getgaal.com/agents/overview.md): Every coding agent gaal supports out of the box.
- [Roo](https://docs.getgaal.com/agents/roo.md): AI coding assistant for VS Code.
- [Trae](https://docs.getgaal.com/agents/trae.md): Adaptive AI IDE by ByteDance.
- [Warp](https://docs.getgaal.com/agents/warp.md): AI-first terminal.
- [Windsurf](https://docs.getgaal.com/agents/windsurf.md): Codeium's AI-first IDE.
- [Zencoder](https://docs.getgaal.com/agents/zencoder.md): Zencoder AI coding agent.
- [gaal agents](https://docs.getgaal.com/cli/agents.md): List registered coding agents and detection status.
- [gaal audit](https://docs.getgaal.com/cli/audit.md): Read-only scan of skills and MCP entries already on this machine.
- [gaal completion](https://docs.getgaal.com/cli/completion.md): Generate shell completion scripts for bash, zsh, fish, and PowerShell.
- [gaal doctor](https://docs.getgaal.com/cli/doctor.md): Health check on configuration, sources, targets, and agents.
- [gaal info](https://docs.getgaal.com/cli/info.md): Detailed view of a single repo, skill, MCP, or agent.
- [gaal init](https://docs.getgaal.com/cli/init.md): Bootstrap a gaal.yaml interactively or from flags.
- [gaal migrate](https://docs.getgaal.com/cli/migrate.md): Validate and prepare configuration for Community Edition.
- [CLI overview](https://docs.getgaal.com/cli/overview.md): Global flags and a one-line summary of every command.
- [gaal schema](https://docs.getgaal.com/cli/schema.md): Print or write the JSON Schema for gaal.yaml.
- [gaal status](https://docs.getgaal.com/cli/status.md): Print the current state of every repo, skill, and MCP entry.
- [gaal sync](https://docs.getgaal.com/cli/sync.md): Reconcile every resource in gaal.yaml against the filesystem.
- [gaal version](https://docs.getgaal.com/cli/version.md): Print the gaal version and build time.
- [Agents & renderers](https://docs.getgaal.com/concepts/agents-and-renderers.md): How gaal knows where each coding agent's files live.
- [The gaal.yaml file](https://docs.getgaal.com/concepts/gaal-yaml.md): The single declarative file that drives every sync.
- [MCP servers](https://docs.getgaal.com/concepts/mcp-servers.md): Upsert MCP server entries into agent configs without clobbering them.
- [Repositories](https://docs.getgaal.com/concepts/repositories.md): Multi-protocol source clones managed by gaal.
- [Scopes](https://docs.getgaal.com/concepts/scopes.md): Global, user, and workspace configuration, and how they merge.
- [Skills](https://docs.getgaal.com/concepts/skills.md): SKILL.md collections, distributed by gaal to every agent that wants them.
- [Telemetry](https://docs.getgaal.com/concepts/telemetry.md): Anonymous usage telemetry, opt-in, off by default.
- [Configure content](https://docs.getgaal.com/configure/content.md): Cookbook for the content: block of gaal.yaml.
- [Custom agents](https://docs.getgaal.com/configure/custom-agents.md): Teach gaal about an agent it doesn't ship with yet.
- [Environment & secrets](https://docs.getgaal.com/configure/environment-and-secrets.md): How to handle tokens, paths, and per-machine values without checking them in.
- [Configure MCP servers](https://docs.getgaal.com/configure/mcp-servers.md): Cookbook for the mcps: block of gaal.yaml.
- [Configure repositories](https://docs.getgaal.com/configure/repositories.md): Cookbook for the repositories: block of gaal.yaml.
- [Configure skills](https://docs.getgaal.com/configure/skills.md): Cookbook for the skills: block of gaal.yaml.
- [How gaal works](https://docs.getgaal.com/how-gaal-works.md): The mental model: one YAML, many renderers, native agent files on disk.
- [Install](https://docs.getgaal.com/install.md): Install gaal on macOS, Linux, or Windows.
- [Introduction](https://docs.getgaal.com/introduction.md): One YAML file. Every coding agent on your machine in sync.
- [Quickstart](https://docs.getgaal.com/quickstart.md): From zero to a synced machine in five minutes.
- [content](https://docs.getgaal.com/schema/content.md): Generic file and directory sync for agent instructions, rules, commands, and settings.
- [hooks](https://docs.getgaal.com/schema/hooks.md): Commands that run before and after gaal sync.
- [mcps](https://docs.getgaal.com/schema/mcps.md): MCP server entries upserted into agent config files.
- [Schema overview](https://docs.getgaal.com/schema/overview.md): The shape of gaal.yaml, key by key.
- [repositories](https://docs.getgaal.com/schema/repositories.md): VCS-managed sources cloned into your workspace.
- [schema](https://docs.getgaal.com/schema/schema-version.md): The configuration version. Always 1 in the current gaal release.
- [skills](https://docs.getgaal.com/schema/skills.md): SKILL.md collections to install per agent.
- [telemetry](https://docs.getgaal.com/schema/telemetry.md): Opt-in anonymous usage telemetry. Off by default.
- [tools](https://docs.getgaal.com/schema/tools.md): CLI tools expected to be on PATH, checked by doctor and sync.
- [Common errors](https://docs.getgaal.com/troubleshooting/common-errors.md): What specific error messages mean and how to fix them.
- [Using gaal doctor](https://docs.getgaal.com/troubleshooting/doctor.md): The first command to run when something looks off.
- [FAQ](https://docs.getgaal.com/troubleshooting/faq.md): Short answers to questions that come up a lot.
- [Previewing changes (--dry-run)](https://docs.getgaal.com/workflows/dry-run.md): See what sync would do before letting it touch your disk.
- [First-time setup from an existing machine](https://docs.getgaal.com/workflows/first-time-setup.md): Turn the skills and MCP servers already on your machine into a gaal.yaml.
- [Sync hooks](https://docs.getgaal.com/workflows/hooks.md): Run local commands before and after gaal sync.
- [Pinning versions](https://docs.getgaal.com/workflows/pinning.md): Lock skills, repositories, and MCP servers to specific revisions.
- [Pruning orphaned resources](https://docs.getgaal.com/workflows/pruning.md): Remove skills and MCP entries gaal used to manage but no longer does.
- [Sandbox mode](https://docs.getgaal.com/workflows/sandbox-mode.md): Redirect every write to a throwaway directory, perfect for CI and testing.
- [Sharing gaal.yaml across machines](https://docs.getgaal.com/workflows/sharing-across-machines.md): The dotfiles pattern: one repo, every machine in sync.
- [Sync once vs. continuous service](https://docs.getgaal.com/workflows/sync-vs-service.md): Pick the right mode for laptops, dev workstations, and CI.

## Optional

- [Website](https://getgaal.com)
- [GitHub](https://github.com/getgaal/gaal)