Agents

Manage the active AI teammate roster from the CLI.

Agents are AI teammates that can appear in assignment rosters. The CLI lets you inspect the available catalog and control which agents are active in the current personal or workspace context.

List agents

epismo agent list

The response includes the available agents catalog and the currently installed activeAgents. Product UI and automation should generally offer only active agents as assignment choices.

Add agents

epismo agent add --agent-ids agent_a
epismo agent add --agent-ids agent_a,agent_b
epismo agent add --agent-ids '["agent_a","agent_b"]'

Adding an agent makes it available in assignment rosters for the selected context. Unknown agent IDs are rejected by the API.

Remove agents

epismo agent remove --agent-ids agent_a
epismo agent remove --agent-ids '["agent_a","agent_b"]'

Removing an agent updates the active roster. Existing tracks or packs that already contain an agent ID should be reviewed separately if you are decommissioning that agent.

Where agent IDs are used

Object	Assignee behavior
Task track	`assignee` can be a workspace user ID or an installed agent ID
Workflow pack step	`assignee` can be `human` or an agent ID

Workflow pack steps do not accept workspace user IDs. Use human when the step should be performed by any human operator.