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

aios <domain> <resource> <action> [flags]

Common domains:

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

Planned Global Flags

aios --help
aios --version
aios --profile default
aios --output json

Planned Infrastructure Workflow Example (Not Yet Implemented)

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)

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

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

​CLI Direction Guide

​Audience

​Goal and Scope

​Planned Command Pattern

​Planned Global Flags

​Planned Infrastructure Workflow Example (Not Yet Implemented)

​Planned Agent Workflow Example (Not Yet Implemented)

​How To Execute Today

​Automation Recommendations

​Related Pages