CLI Reference

Complete list of all naos commands.

Core Commands

Command	Description
`naos init <project>`	Create a new project directory
`naos create <agent>`	Create a new agent
`naos run <agent>`	Start an agent
`naos stop <agent>`	Stop an agent
`naos status`	Show all agents and their status
`naos logs <agent>`	View agent logs
`naos dashboard`	Start the web dashboard
`naos config validate`	Validate nexus.config.yaml

Supervisor Commands

Command	Description
`naos supervisor create <name>`	Create a new supervisor
`naos supervisor add <sup> <agent>`	Add a child agent to a supervisor
`naos supervisor start <name>`	Start a supervisor and all children
`naos supervisor stop <name>`	Stop a supervisor and all children
`naos supervisor status <name>`	Show supervisor tree and status

Saga Commands

Command	Description
`naos saga create <name>`	Create a new saga
`naos saga add-step <saga> <agent>`	Add a step to a saga
`naos saga run <name>`	Execute a saga
`naos saga history <name>`	Show saga execution history

Workflow Commands

Command	Description
`naos workflow create <name>`	Create a new workflow
`naos workflow add-step <wf> <agent>`	Add a step to a workflow
`naos workflow run <name>`	Execute a workflow
`naos workflow status <name>`	Show workflow pipeline status

Pool Commands

Command	Description
`naos pool create <name>`	Create a new agent pool
`naos pool add <pool> <agent>`	Add an agent to a pool
`naos pool run <name>`	Execute all agents in parallel
`naos pool status <name>`	Show pool status and results

Cost Commands

Command	Description
`naos cost set <agent>`	Set a cost budget for an agent
`naos cost status`	Show all cost budgets and spending
`naos cost reset <agent>`	Reset an agent's spend counter

AXIS Trust Commands

Command	Description
`naos axis register <agent>`	Register an agent with AXIS
`naos axis verify <auid>`	Verify an agent's trust status
`naos axis status <agent>`	Show an agent's trust score
`naos axis directory`	Browse the public agent directory
`naos axis cache`	View cached verifications

Broker Commands

Command	Description
`naos broker route "<task>"`	Preview routing decision
`naos broker execute "<task>"`	Route and execute a task
`naos broker stats`	Show routing statistics
`naos broker skills`	List registered skills
`naos broker config`	Show broker configuration

Edge Commands

Command	Description
`naos edge login`	Authenticate with Cloudflare
`naos edge deploy <agent>`	Deploy an agent to the edge
`naos edge list`	List all edge deployments
`naos edge status <agent>`	Show edge deployment status
`naos edge logs <agent>`	Stream edge deployment logs
`naos edge undeploy <agent>`	Remove an agent from the edge

Global Flags

Flag	Description
`--help`	Show help for any command
`--version`	Show version information
`--verbose`	Enable verbose output
`--quiet`	Suppress non-essential output