Skip to main content

​
CLI Guide

​
Audience

This page is for users driving scripts, CI/CD, and batch operations through CLI.

​
Goal and Scope

This page explains CLI structure, core workflows, and automation usage patterns.

​
Command Pattern

aios <domain> <resource> <action> [flags]
Common domains:
  • infra for infrastructure operations
  • agent for agent lifecycle and workflows
  • config for global configuration

​
Global Flags

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

​
Infrastructure Workflow Example

aios infra cluster up
aios infra app deploy my-ai-api --namespace dev-ai --replicas 2
aios infra app logs my-ai-api --follow

​
Agent Workflow Example

aios agent tool add codex --token $CODEX_TOKEN
aios agent run --tool codex --task "Add API tests"
aios agent run list --limit 20

​
Automation Recommendations

  • use --output json in CI
  • keep secrets in secure environment variables
  • run aios doctor before critical workflows