---
title: "All Commands"
description: "Complete list of all naos 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 Sh"
resource: https://www.aiagents.nexus/docs/cli-reference/all-commands
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# 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 |