aasm topology

Visualize agent topology — fleet overview, delegation trees, teams, ancestry lineage, and aggregate statistics.

Synopsis

aasm topology <SUBCOMMAND> [OPTIONS]

Subcommand	Purpose
`overview`	Fleet-wide topology overview.
`tree`	Render a subtree rooted at a given agent.
`team`	Show all agents in a team.
`lineage`	Show the ancestry chain for a given agent.
`stats`	Show aggregate topology statistics.

All subcommands accept the global options, including --output table|json|yaml (tables render via box-drawing trees for tree/lineage).

aasm topology overview

Show a fleet-wide topology overview across all teams and root agents.

Flag	Type	Default	Description
`--status <STATUS>`	string	—	Filter agents by status (`active`, `suspended`, `deregistered`).
`--show-budget`	flag	off	Include governance level in agent nodes.

aasm topology overview --status active

aasm topology tree

Render a delegation subtree rooted at one agent, using box-drawing characters.

Name	Type	Default	Description
`<AGENT_ID>`	string (arg)	—	Root agent ID (hex-encoded UUID).
`--max-depth <DEPTH>`	integer	`10`	Maximum traversal depth from the root.
`--status <STATUS>`	string	—	Filter tree nodes by status.
`--show-budget`	flag	off	Include governance level in tree nodes.

aasm topology tree a1b2c3… --max-depth 3

research-bot (a1b2c3…)
├── fetch-worker (d4e5f6…)
│   └── parse-worker (778899…)
└── summarize-worker (aabbcc…)

aasm topology team

Show all agents belonging to a single team.

Name	Type	Default	Description
`<TEAM_ID>`	string (arg)	—	Team ID.
`--status <STATUS>`	string	—	Filter members by status.
`--show-budget`	flag	off	Include governance level in agent nodes.

aasm topology team research --status active

aasm topology lineage

Show an agent’s complete ancestry chain, ordered root-first.

Name	Type	Default	Description
`<AGENT_ID>`	string (arg)	—	Agent ID (hex-encoded UUID).
`--show-permissions`	flag	off	After the lineage, also print the agent’s effective capability set with cascade provenance.

aasm topology lineage 778899… --show-permissions

root-bot (a1b2c3…)
└── fetch-worker (d4e5f6…)
    └── parse-worker (778899…)   ← target

aasm topology stats

Show aggregate topology statistics — total/root/active/suspended counts, max depth, team sizes, and depth/spawn histograms. Takes no flags of its own (uses the global --output).

aasm topology stats --output json

Total agents:    42
Root agents:     5
Max depth:       4
Active:          38   Suspended: 3   Deregistered: 1
Teams:           5
Avg children/parent: 2.31

Last updated: 2026-06-11 by Chisanan232

Keyboard shortcuts