gaal status

gaal status [flags]

Reports the actual state of every resource managed by gaal.yaml, what’s on disk, what version, where it lives. status writes nothing.

Flags

Only the global flags. The -o json flag is most useful here for scripting.

Sample output

$ gaal status
repositories
  src/gaal               git · main · clean
  src/anthropics-skills  git · v1.4.0 · clean

skills
  frontend-design        claude-code, cursor (project)
  skill-creator          claude-code (project)
  git-helper             claude-code (global)

mcps
  filesystem             ~/.claude.json
  github                 ~/.claude.json
  filesystem             ~/.cursor/mcp.json

Use -o table for a boxed pterm layout with coloured status cells, or -o json for structured data.

Sample output (JSON)

gaal status -o json

{
  "repositories": [
    { "path": "src/gaal", "type": "git", "version": "main", "dirty": false }
  ],
  "skills": [
    { "name": "frontend-design", "agents": ["claude-code", "cursor"], "scope": "project" }
  ],
  "mcps": [
    { "name": "filesystem", "target": "~/.claude.json" }
  ]
}

CLI reference

gaal status

Flags

Sample output

Sample output (JSON)

gaal info

gaal doctor

​Flags

​Sample output

​Sample output (JSON)

​Related

gaal info

gaal doctor

Flags

Sample output

Sample output (JSON)

Related