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

# manage_agents

> Scaffold, list, toggle, and configure agents and subagents from the command line.

This page will document every subcommand of `python -m app.cli.manage_agents`
(also reachable as `ziro agents`): `list` to show agents with their on/off state
and a separate spawn-only section for subagents; `add <id> --name NAME` to
scaffold a new agent, seeded from the default agent or from `--template <id>`, or
meta-only with `--no-copy`; `remove <id>` to delete one; `enable` and `disable` to
toggle a single agent's `meta.yaml` flag; `set-default <id>` to choose the agent
used when none is named; and `set-model <id> <model>` to pin an agent's model
(`none` clears it back to the environment default).

It also covers the single-file subagent commands: `add-subagent <id> --tools a,b --namespaces rag,memory --skills x,y` writes `.subagents/<id>.agent.md`, and
`remove-subagent <id>` deletes it. Subagents are spawn-only and never appear in
the interactive picker.

<Note>
  This page is in progress. See [agent files](/reference/agent-files) for what each
  scaffolded file controls.
</Note>

<Columns cols={2}>
  <Card title="Agents" icon="boxes" href="/concepts/agents">
    How an agent is resolved and what a profile carries.
  </Card>

  <Card title="Subagents" icon="git-branch" href="/concepts/subagents">
    Delegation, rights intersection, and `*.agent.md`.
  </Card>
</Columns>