Skip to main content
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.
This page is in progress. See agent files for what each scaffolded file controls.

Agents

How an agent is resolved and what a profile carries.

Subagents

Delegation, rights intersection, and *.agent.md.