> ## 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 status

> Print the current state of every repo, skill, and MCP entry.

```bash theme={"theme":"nord"}
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](/cli/overview#global-flags). The `-o json` flag is most useful here for scripting.

## Sample output

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

```bash theme={"theme":"nord"}
gaal status -o json
```

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

## Related

<CardGroup cols={2}>
  <Card title="gaal info" icon="circle-info" href="/cli/info" />

  <Card title="gaal doctor" icon="stethoscope" href="/cli/doctor" />
</CardGroup>