gaal doctor

gaal doctor [flags]

Validates gaal.yaml, checks that every source is reachable, verifies every MCP target is writable, confirms any declared tools: are on PATH, and reports agent and telemetry status. Run it any time gaal is misbehaving, and as a CI gate.

Flags

Flag	Default	Description
`--offline`	off	Skip network reachability checks.
`--no-upsell`	off	Suppress the Community Edition graduation message.

Plus all global flags.

Exit codes

Code	Meaning
`0`	All checks passed.
`1`	Warnings only, gaal will function.
`2`	Errors, gaal cannot operate as configured.

gaal doctor && echo "ready to sync"

Sample output

$ gaal doctor
config:
  ✓ ./gaal.yaml parses against schema 1
  ✓ no scope-restricted fields in workspace
sources:
  ✓ anthropics/skills          reachable
  ✓ vercel-labs/agent-skills   reachable
mcps:
  ✓ ~/.claude.json   writable
  ✓ ~/.cursor/mcp.json                            writable
tools:
  ✓ gh           (on PATH: /opt/homebrew/bin/gh)
  ! rtk          — missing from PATH (required by: workspace; hint: cargo install rtk)
agents:
  installed: claude-code, cursor, codex
  not installed: github-copilot, windsurf
telemetry:
  ✓ disabled (per ~/.config/gaal/config.yaml)

3 agents installed, 0 misconfigured

CI usage

- run: gaal doctor --offline
- run: gaal --sandbox "$RUNNER_TEMP/gaal-sb" sync --dry-run
- run: gaal --sandbox "$RUNNER_TEMP/gaal-sb" sync

--offline is essential in air-gapped or rate-limited CI environments.

CLI reference

gaal doctor

Flags

Exit codes

Sample output

CI usage

Using gaal doctor

Common errors

​Flags

​Exit codes

​Sample output

​CI usage

​Related

Using gaal doctor

Common errors

Flags

Exit codes

Sample output

CI usage

Related