> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getgaal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# gaal doctor

> Health check on configuration, sources, targets, and agents.

```bash theme={"theme":"nord"}
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](https://docs.getgaal.com/cli/overview.md#global-flags).

## Exit codes

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

```bash theme={"theme":"nord"}
gaal doctor && echo "ready to sync"
```

## Sample output

```text theme={"theme":"nord"}
$ 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

```yaml theme={"theme":"nord"}
- 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.

## Related

> [card] [Using gaal doctor](https://docs.getgaal.com/troubleshooting/doctor.md)

> [card] [Common errors](https://docs.getgaal.com/troubleshooting/common-errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.