> ## 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 方向指南

> AiOS 未来 CLI 的命令结构方向，以及当前仓库应如何理解 bootstrap/server 入口。

# CLI 方向指南

> 当前仓库尚未交付本页中的多子命令 CLI。可执行入口仍是 `go run ./cmd/aios` 启动的 bootstrap/server binary。

## 适用对象

本页面适用于规划 CLI 自动化接入的维护者、集成方与文档作者。

## 目标与范围

本页说明未来 CLI 的命令结构方向，以及当前仓库如何避免把规划误写成已实现能力。

## 未来命令结构方向

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

常见 domain：

* `infra`：基础设施管理
* `agent`：Agent 生命周期与工作流
* `config`：全局配置

## 未来全局参数方向

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

## 规划中的基础设施工作流示例（尚未实现）

```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
```

## 规划中的 Agent 工作流示例（尚未实现）

```bash theme={null}
aios agent tool add codex --token $CODEX_TOKEN
aios agent run --tool codex --task "补齐接口测试"
aios agent run list --limit 20
```

## 当前仓库如何执行

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

## 自动化建议

* 在 CLI 真正落地前，CI 应直接调用已实现的 HTTP API，而不是依赖本文中的规划命令
* 将 token 放入安全环境变量，不写入脚本明文
* `aios doctor` 等命令当前仍属未来 CLI 方向

## 相关页面

* [Agent 总览](/agent/index)
* [CLI 参考](/reference/cli-reference)
* [生产环境二次验证与审批](/agent/production-approval)