> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Direction Reference

> Planned AiOS CLI command model reference plus the current bootstrap/server boundary.

# CLI Direction Reference

> The repository does not currently implement the CLI commands listed below. This page preserves the planned command model only and must not be read as current `cmd/aios` behavior.

## Current Executable Entry

Terminal A:

```bash theme={null}
go run ./cmd/aios
```

Terminal B:

```bash theme={null}
curl http://localhost:8080/healthz
curl http://localhost:8080/readyz
```

## Planned Global Flags

| Flag        | Description            | Example                                    |
| ----------- | ---------------------- | ------------------------------------------ |
| `--profile` | Select runtime profile | `aios --profile prod infra cluster status` |
| `--output`  | Set output format      | `aios --output json agent run list`        |
| `--help`    | Show help              | `aios infra --help`                        |
| `--version` | Show version           | `aios --version`                           |

## Planned Infrastructure Commands (Not Yet Implemented)

| Command            | Description          | Example                                                        |
| ------------------ | -------------------- | -------------------------------------------------------------- |
| `infra cluster up` | Create/adopt cluster | `aios infra cluster up`                                        |
| `infra app deploy` | Deploy application   | `aios infra app deploy my-api --namespace dev-ai --replicas 2` |
| `infra app logs`   | Stream app logs      | `aios infra app logs my-api --follow`                          |

## Planned Agent Commands (Not Yet Implemented)

| Command          | Description           | Example                                              |
| ---------------- | --------------------- | ---------------------------------------------------- |
| `agent tool add` | Register tool adapter | `aios agent tool add codex --token $CODEX_TOKEN`     |
| `agent run`      | Submit task run       | `aios agent run --tool codex --task "Add API tests"` |
| `agent run list` | List recent runs      | `aios agent run list --limit 20`                     |
| `agent run logs` | Fetch run logs        | `aios agent run logs <run-id>`                       |

## Related Pages

* [Agent Overview](/en/agent/index)
* [Production Step-Up and Approval](/en/agent/production-approval)
* [Operations Overview](/en/operations/index)