---
title: "CLI Overview"
description: "The naos command line interface is the primary way to interact with Nexus OS. Flag Description help Show help for any command version Show version config <path Custom config file path data dir <path Custom data directory"
resource: https://www.aiagents.nexus/docs/manual/cli-reference/overview
generated: { by: "process:nexus-agent-assets", at: 2026-09-07T09:13:03Z }
status: stable
---

# CLI Reference

The `naos` command-line interface is the primary way to interact with Nexus OS.

## Global Options

| Flag | Description |
|------|-------------|
| `--help` | Show help for any command |
| `--version` | Show version |
| `--config <path>` | Custom config file path |
| `--data-dir <path>` | Custom data directory |

## Command Groups

| Group | Description |
|-------|-------------|
| `naos init` | Initialize a new project |
| `naos create` | Create agents |
| `naos run` | Run agents |
| `naos stop` | Stop agents |
| `naos status` | Check agent status |
| `naos supervisor` | Manage supervisors |
| `naos saga` | Manage sagas |
| `naos workflow` | Manage workflows |
| `naos pool` | Manage pools |
| `naos cost` | Cost management |
| `naos axis` | Trust verification |
| `naos broker` | Broker routing |
| `naos edge` | Edge deployment |
| `naos dashboard` | Web dashboard |
| `naos audit` | Audit log |