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

> Planned AiOS CLI command structure and the current bootstrap/server reality of the repository.

# CLI Direction Guide

> The repository does not currently ship the multi-command CLI shown on this page. The executable entrypoint today is still the bootstrap/server binary started with `go run ./cmd/aios`.

## Audience

This page is for maintainers, integrators, and doc authors planning future CLI automation entrypoints.

## Goal and Scope

This page explains the planned CLI shape and how to avoid presenting roadmap commands as if they were already implemented.

## Planned Command Pattern

```bash theme={null}
aios <domain> <resource> <action> [flags]
```

Common domains:

* `infra` for infrastructure operations
* `agent` for agent lifecycle and workflows
* `config` for global configuration

## Planned Global Flags

```bash theme={null}
aios --help
aios --version
aios --profile default
aios --output json
```

## Planned Infrastructure Workflow Example (Not Yet Implemented)

```bash theme={null}
aios infra cluster up
aios infra app deploy my-ai-api --namespace dev-ai --replicas 2
aios infra app logs my-ai-api --follow
```

## Planned Agent Workflow Example (Not Yet Implemented)

```bash theme={null}
aios agent tool add codex --token $CODEX_TOKEN
aios agent run --tool codex --task "Add API tests"
aios agent run list --limit 20
```

## How To Execute Today

```bash theme={null}
go run ./cmd/aios
curl http://localhost:8080/healthz
curl http://localhost:8080/readyz
```

## Automation Recommendations

* until the CLI exists, CI should call implemented HTTP APIs directly instead of relying on the planned commands on this page
* keep secrets in secure environment variables
* `aios doctor` and similar commands remain future CLI direction only

## Related Pages

* [Agent Overview](/en/agent/index)
* [CLI Reference](/en/reference/cli-reference)
* [Production Step-Up and Approval](/en/agent/production-approval)