Skip to main content
telemetry: <bool>

​
Type

bool

​
Required

No. Defaults to false. gaal collects nothing unless this is explicitly set to true.

​
Scope restriction

This field is only honoured in:
  • The user-scope file: ~/.config/gaal/config.yaml (or $XDG_CONFIG_HOME/gaal/config.yaml / %AppData%\gaal\config.yaml).
  • The system-scope file: /etc/gaal/config.yaml.
A workspace gaal.yaml that sets telemetry: is ignored with a warning. This rule prevents a checked-in repo file from opting contributors into telemetry. See Scopes for the full restriction policy.

​
What’s collected when enabled

Per command invocation:
  • Command name (sync, doctor, …).
  • Exit code class (ok, warning, error).
  • gaal version.
  • OS family (linux, darwin, windows).
  • A randomly generated, locally stored install ID.
No file paths, no skill names, no MCP target paths, no URLs from your config. See Concepts → Telemetry and the Privacy Policy for the complete description.

​
Examples

# ~/.config/gaal/config.yaml
telemetry: true

# ~/.config/gaal/config.yaml
telemetry: false

​
Verifying

$ gaal doctor
…
✓ telemetry: disabled (per ~/.config/gaal/config.yaml)

Concepts: Telemetry

Scopes