阿波罗CLI - @aui.io/apollo

作者,测试,操作阿波罗特工 从您的终端.

阿波罗CLI是操作控制台 操作控制台的代理 阿波罗1号, (中文(简体) ), AUI神经-同义基模型. 一个安装给你两个表面:

• 可脚本命令行接口 - apollo <command>,带有 --json 模式 脚本和编码代理;
• 全屏终端 UI( 空白) apollo),为作者 + 验证 → 测试 → 推回环.

一个特工的程序是 键入了 YAML 代码库 您在本地端的检出中保留, 在您的编辑中编辑 具有计划支持的 IDE, 验证, 测试实时运行时间, 并按新程序推回 各个版本。 同一代理商可进入 游戏场。 。 。 .

完整文档 : 文献:aui.io/cli

所需资源

不需要安装 npm 登录 。 "TUI"是建立在 打开TUI 在Bun上运行:当从节点发射时, apollo 透明地重新执行TUI 下级 bun 从你的 PATH; 没有 Bun ,它会打印 安装导和 CLI 仍然完全可以使用.

安装

npm install -g @aui.io/apollo
apollo --version
apollo doctor          # checks Node/Bun, the install, your terminal and connectivity

稍后升级为:

apollo upgrade            # install the latest version from npm
apollo upgrade --check    # show the available version only

快开始

# 1. Sign in — opens the browser flow in the Playground
apollo login

# 2. Create a new agent, or import one you already have
apollo agent create "Returns Assistant"      # or: apollo agent import <agent-id>
cd <the printed checkout directory>          # defaults to ~/apollo/<profile>/<env>/<name>-<id>

# 3. Edit the program under bundle/src/
#    program.yaml · vocabulary.yaml · situations.yaml · sources.yaml ·
#    derivations.yaml · connections.yaml · capabilities/ · policies/

# 4. Validate — deterministic, with every finding located in a file
apollo validate

# 5. Talk to it against the live runtime WITHOUT deploying, and read the trace
apollo chat "I want to return an order" --local . --trace

# 6. Push the change, then make that SAVE the one customers get, when it is ready
apollo push -m "Describe the change"
apollo branch list
apollo branch live <tag>          # `v3.7` ships exactly that save; `v3` ships its newest

apollo status 总是告诉你你站在哪里 什么样的情况 组织 计划, 代理机和版本已激活, 并锁定退出的运行时间 .

CLI的看法

上下文为 职位: 最近的一个 .apollorc 从当前目录上走 选择您正在工作的代理, 因此 cd 输入一个退出,每个命令都适用 给那个探员.

图标

status      [--check]                          active context (+ service connectivity)
doctor      [--offline]                        diagnose the setup; exit 2 on problems
upgrade     [version] [--check] [--force]      upgrade from npm
login       [--sso | --email <e> [--otp <c>] | --token <jwt>]
logout
profile     current | list | use <name>
org         list | use <id>
project     list | use <id> | create <name>
agent       list | create <name> [--dir <path>] [--template <id>]
            | import [agent-id] [--tag <tag>] [--dir <path>] [--skills <targets>] [--force]
            | use <target> | path | unlink
runtime     list | show | use [version]
validate    [directory]                        validate the local program (exit 2 on errors)
diff        [--remote]                         compare local files with the last baseline
pull        [--tag] [--dir] [--force] [--skills cursor,claude,opencode] [--no-skills] [--no-schemas]
push        -m <message> [--dry-run]           validate and push local changes as a new version
version     list | get <tag> | use <tag> | create [--from <tag> | --template <id>] [--label] [--notes]
            | publish <tag> | archive <tag>
chat        [text…] [--thread <id>] [--local <dir>] [--var k=v] [--trace]
thread      create | list | get <id> | messages <id> | trace <id>
regress     [--scenarios <ids>] [--explain] [--follow] [--status] [--cancel] [--pull]
evaluate    [directory] [guidelines] [--simulations <n>] [--min-turns] [--max-turns] [--seed] [--follow]
advise      <question> [--fresh] [--model] [--max-usd]
build       <instruction> [-m] [--version-tag] [--publish] [--model] [--max-usd]
mockdb      provision [--wire] | status | describe | export | keys | wire | clone --from <id> | reset [--scope data|all] --force | delete --force
            | collections create | update | list | truncate | delete · seed (--rows | --file) [--mode] · rows list | patch | delete
            | endpoint create | list | get | update | delete · execute --slug <s> [--session] [--body] · session get | reset · rotate mgmt | runtime
            | identities get | set · guide
vault       set <NAME> | list | get <NAME> | rm <NAME> --force
kb          list | status <name> | create <name> | add <hub> <files…> | add-url <hub> <urls…>
            | check | export [name] | delete <name> --force | connections | resync <hub>
report      <title> [--kind] [--confidence] [--summary] [--tried …] [--command] [--dry-run] [--no-session]
shell-init                                     print the shell hook (see below)

运行 apollo <command> --help 用于您已安装的版本中的活式旗帜列表 指令表面对照CLI本身进行验证,所以 --help 总是权威.

全球旗帜( 在子命令前)

--json (脚本的稳定信封)- --quiet • 妇女 --verbose (外诊断, 包括每个API请求一条直播线)- --no-input • 妇女 --yes • 妇女 --profile <name> • 妇女 --project <id> • 妇女 --org <id> • 妇女 --runtime-version <version> • 妇女 --timeout <ms>

JSON 模式总是发出 {"success":true,"data":…} 或者说 {"success":false,"error":{"code","message","suggestion"}}。 。 。 . 退出代码 : 0 成功 · 1 运行时间/ API 失败 2 验证失败 ^ 3 auth/ 配置失败 .

认证

apollo login                               # browser sign-in via the Playground (default)
apollo login --email [email protected]       # email one-time code, then prompts for it
apollo login --token "$ACCESS_TOKEN"       # store a pre-issued access token
apollo whoami                              # who this session acts as, checked with identity
apollo logout

全权证书按 配置文件 内 ~/.apollo/credentials.json (模式) 0600) (中文(简体) ). 使用配置文件并存多个账户( U)apollo profile use work,或 --profile work 一个命令.

CI和自动化: 设定 APOLLO_TOKEN 在环境中运行 --json --no-input没有提示,每个结果都是机器可读信封. 一个 APOLLO_TOKEN 运行从不触及已保存的登录: 过期的符号失败 AUTH_ERROR 而不是向存储在磁盘上的人刷新.

与编码代理合作

CLI的设计是由编码剂和人类一样驱动. apollo agent import 编号 : apollo pull 安装作者 技术包 还有一个 AGENTS.md 输入 离职( e)--skills cursor,claude,opencode 选择目标; --no-skills 跳过他们, cursor、 Claude Code 和 OpenCode 等工具可以编写、验证、测试和推动 代理结束结束. apollo advise "<question>" 询问服务器侧作者顾问 您的离职,和 apollo build "<instruction>" 运行一个大楼 翻过被推进的代理.

一分钟之内的TUI

裸体 apollo 在 TTY 上发射终端 UI(apollo tui 编号 : --tui 强制; 任何 子命令, --json, (中文(简体) ), --no-input 或非TTY总是运行CLI; APOLLO_TUI=0 保持一个 赤裸的TTY在CLI上。 两种主要模式—— 作者 (验证,diff,推,拉,版本, 资源、假设情景) 说话 (与运行的代理交谈).

在作者中,单字母运行为快动作(v 验证 · d iff p 推动.. l 拖动.. r 版本 · m * 资源 s 情况 o 在 IDE 中打开,并免费 文本是给作者后端的副驾驶指示。 在"谈"中,作曲家会发出 所有的一切 代理逐字记录.

测试代理

数据您的代理读取

• 模拟数据库 —— 说 apollo mockdb … 提供可种子的每剂模拟数据库 并用已宣布的终点来构建和测试现实数据,然后才进行真实的 后端存在 . apollo mockdb guide 将完整的方式写入您的离职.
• 知识中心 —— 说 apollo kb … 创建中枢、上传文档或刮去 URL 他们,检查程序 hub: 推前的参考文献。 作为枢纽的连接器 (Notion, Collection, Google Drive,.)同步, kb connections 显示其同步过程 财务报告和审定财务报表 kb resync <hub> 现在运行一个.
• 秘诀 —— 说 apollo vault set <NAME> 按名称存储连接证书; 程序 参考它们(token_env, (中文(简体) ), ${NAME}(单位:千美元) bundle/src/connections.yaml 永不携带 一个值.

诊断

apollo doctor             # diagnose the setup end to end; exit 2 on problems
apollo status --check     # context + per-service reachability/auth
apollo --verbose <cmd>    # stream each API call live to stderr

apollo doctor 检查运行时间(Node/Bun),安装来源, shell 集成, APOLLO_* 覆盖 正在使用的代理 终端能力 证书权限, 符号过期, 当前检出, 和服务可达性 —— 只读, 有固定 随附每个发现。 在报告问题时分享其产出.

apollo report "<the fault>" 文件错误不是程序的错误——引擎 cLI违反合约 失败 —— 您的登录 。 它附加了检出,引擎构建,CLI版本 并且,在一个编码代理下,会话命令, 清除秘密(无论你是什么) 类型d); --dry-run 准确显示将发送什么。 CLI 也自行存档崩溃和 背景中的服务器出错 . APOLLO_REPORTS=0 全部关掉.

--verbose 溪流一 已编辑 每个 API 请求的行数( 自动/ 托肯/ 密钥/ 秘密值) 从未出现过) stderr——一个没有得到答复的请求说为什么(拒绝连接,a 超时, 一个不信任的证书; TUI 显示同一流的活性 抽屉.

在公司代理的背后

把代理设置在卷曲的方式。 CLI和TUI提出的每一项要求 更新检查,然后通过:

export HTTPS_PROXY=http://proxy.example.com:8080       # user:password@ before the host if it needs a login
export NO_PROXY=localhost,127.0.0.1                     # hosts that skip it; .example.com covers subdomains
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem    # only if the proxy inspects HTTPS
apollo doctor                                           # shows the proxy in use and what each service answers

小写表( E)https_proxy, (中文(简体) ), http_proxy, (中文(简体) ), no_proxy)工作也,当两者同时获胜 已经设定。 只有 HTTP( S) 代理被支持—— 一个空 host:port 读作 http://host:port,以及任何其他计划socks5://,.)因姓名而不是姓名而被拒绝 默然而去.

文件和环境变量

~/.apollo/
  config.json          # profile, default projects
  credentials.json     # tokens (mode 0600 — the only secret-bearing file)
  checkouts.json       # known-checkouts registry
  baselines/…          # sync hashes for diff/push

<checkout>/.apollorc   # org / project / agent / version_tag binding
<checkout>/bundle/src/ # the editable program source

完整表格,包括每个服务的 URL 覆盖,在 配置参考。 。 。 .

壳牌集成

邮站台阶提供一个小贝壳钩(或自己加入) eval "$(apollo shell-init)": 它让 apollo agent use / import / create 放下枪 shell 直接输入出账目录 .

文件和支助

• CLI 概况 • 妇女 安装 • 妇女 图标 • 妇女 配置 • 妇女 工作流量
• 阿波罗一号文档 ——程序模型,Message API,代理构建器API和SDK
• 游戏场 ——浏览器中相同的代理
• 问题:运行 apollo doctor,则 联系AUI 及其产出

使用条件

使用此软件包,以及它所称的阿波罗API,均受以下规范: AUI API 和开发者成套服务条款。 。 。 . 通过安装或使用 @aui.io/apollo 你同意这些条件.

AUI (英语). 版权所有.