Skip to main content
gaal is a single CLI that keeps your local repositories, AI agent skills, and MCP server configurations in sync from one declarative gaal.yaml file. If you use Claude Code at work, Cursor at home, and try Codex on the side, your skills and MCP servers usually live in three places, .claude/, .cursor/, ~/.codex/, drifting out of sync the moment you set up a new machine. gaal fixes that. You write one file, run gaal sync, and every installed agent gets the same tools.

​
What gaal manages

ResourceWhat it does
RepositoriesClones or updates Git, Mercurial, Subversion, Bazaar, tar, and zip sources into your workspace.
SkillsInstalls SKILL.md collections into each agent’s native skills directory (.claude/skills, .cursor/skills, .github/skills, …).
MCP serversUpserts MCP server entries into each agent’s JSON config file without touching your other settings.

​
What it looks like

gaal.yaml
schema: 1

repositories:
  src/gaal:
    type: git
    url: https://github.com/getgaal/gaal.git
    version: main

skills:
  - source: anthropics/skills
    agents: ["*"]            # install in every detected agent
    select:
      - frontend-design
      - skill-creator

mcps:
  - name: filesystem
    target: ~/.config/claude/claude_desktop_config.json
    inline:
      command: uvx
      args: [mcp-server-filesystem, ~/projects]

$ gaal sync
✓ src/gaal              up-to-date
✓ skills/frontend-design installed in claude-code, cursor
✓ mcp/filesystem        upserted in claude_desktop_config.json

​
Who it’s for

  • Solo developers running multiple coding agents who want their setup reproducible across machines via dotfiles.
  • Power users maintaining curated skill sets across projects and teams.
  • Anyone tired of copy-pasting MCP JSON snippets between agents.

​
What’s next

Install gaal

Five ways to get the binary on your machine.

Quickstart

Audit, init, and sync in five minutes.

How gaal works

The mental model: YAML → renderers → agent files.

The gaal.yaml file

Top-level keys and how they fit together.

​
What’s next for gaal

gaal today is the free, single-user CLI documented on this site. A team-focused Community Edition with shared registries, drift detection, and approval workflows is in development. See gaal migrate for the graduation path.