Agents and Actors

Agents are the persistent, identifiable entities that carry work in matic — spawned from Archetypes, durable across runs, and routed work through Probes, Staffing, and the Signal pipeline. These commands cover the agent lifecycle from spawn through decommission, plus the read and message surfaces operators use day-to-day. Use them to manage who exists in your org, what state they're in, and how the Daemon interacts with them.

agent-spawn

Instantiate a new agent from an Archetype, initializing its directory, Persona, Skills, Probes, Memory, and Work Pile.

agent-list

Enumerate agents in the current org, filtered by lifecycle state, team, archetype, or capability.

agent-inspect

Read an agent's full operational state — Memory, Experience, Probes, recent Runs, and current Work Pile.

agent-assign

Force-route a Task or Work Item to a specific agent, bypassing Staffing's normal Probe-based selection.

agent-suspend

Stop the Daemon from routing new work to an agent while preserving all state for later reactivation.

agent-kill

Decommission an agent permanently, capturing knowledge transfer — Archetype updates, Library contributions, Work Pile reassignment — before retirement.