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

# Agent

> List and inspect file-based custom agent definitions

Manage **custom agents** discovered from `.praisonai/agents/` — distinct from `praisonai agents` (the multi-agent UI command).

## Commands

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai agent list [--verbose]
praisonai agent show <name>
```

| Command          | Description                             |
| ---------------- | --------------------------------------- |
| `list`           | Show Name, Source (user/project), Model |
| `list --verbose` | Also Path and Role                      |
| `show <name>`    | Agent details, system prompt, tools     |

## Examples

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai agent list
praisonai agent list --verbose
praisonai agent show researcher
```

<Tip>
  No agents yet? Run [`praisonai init`](/docs/cli/init) to scaffold a working starter agent in `.praisonai/agents/assistant.md`.
</Tip>

## Related

<CardGroup cols={2}>
  <Card title="Custom Agents & Commands" icon="file-code" href="/docs/features/custom-agents-commands">
    Define agents from Markdown
  </Card>

  <Card title="Run" icon="play" href="/docs/cli/run">
    Run with --agent
  </Card>

  <Card title="Init" icon="wand-magic-sparkles" href="/docs/cli/init">
    Scaffold a starter agent in one command
  </Card>
</CardGroup>