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

# graph agent list

> List every agent: built-in, global (~/.config/graph/agents), and project (./.graph/agents)

Prints each agent's name, source and description. `--json` adds its model, subagents, handoffs, how it is called as a subagent (`subagentIo`), and any files that failed to load (`loadErrors`).

## Options

**--json** `boolean`

Print a JSON envelope instead of text

## Global options

**-v, --verbose** `integer`

Increase log verbosity (-v info, -vv debug, -vvv trace)

```bash Usage theme={null}
graph agent list [OPTIONS]
```

```bash Example 1 theme={null}
graph agent list
```

```bash Example 2 theme={null}
graph agent list --json
```


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