文档目录
ail 除了 desk 和 daemon 两种常驻的运行方式,其余子命令都是向 Desk 办事的命令行。会话里的 Agent 在自己的 shell 工具里敲 ail <子命令>;你在任何一台 Client 的终端里用的是同一批。
- 身份。 环境里有会话的身份变量时,以会话的身份办事;没有时用这台 Client 配对得到的凭据,以 Client 的身份办事;两样都没有就报错退出。
- 不等。 每个子命令最多等 8 秒。要等别人的事只登记,返回编号或链接;活儿做不完就转成后台的操作,命令返回
{"ok": true, "pending": {"op": "<操作编号>"}},活在 Desk 和 Daemon 里接着做完。
- 文件由 Daemon 搬。 命令行只把本机的路径交给 Desk,文件内容由 Daemon 读写。
- 输出。 结果写标准输出,日志写标准错误。多数子命令输出一行 JSON;失败时退出码是 1,输出
{"ok": false, "error": {"code": …, "message": …}}。
- 文本不写在参数里。 含引号、
$、换行的文本先写成文件,再用 --…-file 传;ail shell 的命令经 --stdin 传。
- 大的输出写文件。 带
--out <文件> 时结果写进文件,命令只打印一行摘要。
| 命令 |
做什么 |
ail desk --listen <地址:端口> --data <数据目录> |
运行 Desk |
ail desk pairing --client-id <id> |
在 Desk 那台电脑上签发一个配对码 |
ail desk authz list|allow|revoke |
看、加、撤授权规则 |
ail pair --desk <地址> --code <配对码> --client-id <id> |
在一台 Client 上配对 |
ail daemon --plugins <插件目录> |
运行 Daemon |
ail version、ail status |
版本;这台 Client 的 id、Desk 的地址、连没连上 |
ail setup desk|daemon|upgrade|rollback|remove |
装成常驻、升级、回滚、卸载,见安装与升级 |
| 命令 |
做什么 |
ail whoami |
这次调用的主体、所在的 Client;会话另给出它的环境、运行和角色 |
ail shell [--target <Client>] [--shell powershell|bash] … |
非交互执行,见跨端 |
ail sync、ail get、ail put |
远端工作区:同步镜像,取、放单个文件 |
ail prompt --out <文件> |
把这个会话的第一条消息写到文件 |
ail doc list、ail doc get <名> |
官方默认插件里用到时才取的文档与模板 |
ail worktree start|finish|drop|leftovers |
改动,见工作流与引擎 |
ail call <角色> "<要它做什么>" |
调用一个工具类角色,立即返回调用编号 |
ail report review|present|ask|preview|withdraw |
推报告、提问、预览、撤回,见报告 |
ail op <操作编号> |
一个转成后台的操作现在怎样 |
| 命令 |
做什么 |
ail session new --client <Client> --cwd <目录> --harness <id> |
开一个会话,输出会话 id。加 --harness-client 让 Harness 在另一台 Client 上启动 |
ail session list |
列出会话 |
ail session show <会话> |
会话的事件 |
ail session close <会话> |
关闭它的适配进程;之后再发消息会重连 |
| 命令 |
做什么 |
ail dispatch --repo <repo id> --intent <意图> --title "<标题>" --request-file <文件> |
开始一个运行,输出运行 id |
ail continue <运行> |
续接 |
ail send <运行或会话> --request-file <文件> |
发消息,可以带图片 |
ail stop <运行或会话> |
取消正在进行的一轮 |
ail archive <运行> |
归档;用在没结束的运行上就是终止 |
ail result <运行或会话> |
最近一次报告的全文 |
ail board |
看板 |
ail map <repo id> |
地图 |
ail log runs|show|stats |
运行流水 |
ail journal record|list |
记一条 Journal、列出 Journal |
ail router status |
Router 会话在哪、合同现在的版本 |
| 命令 |
做什么 |
ail plugin sync |
同步主仓和登记的全部仓库 |
ail plugin status |
每个仓库在哪台 Client、检出的提交、有没有未提交的改动 |
ail repo list、ail repo find <关键词> |
列出、查找登记的 Repo |
ail repo add、ail repo update、ail repo archive |
登记、改登记、归档 |
| 子命令 |
谁能用 |
dispatch、continue、send、stop、archive |
Router 会话和你 |
session new、session close |
你 |
prompt、worktree、call、report、sync、get、put |
只有会话:它们作用在调用它的那个会话上 |
shell --target |
照授权规则 |
| 其余 |
任何主体 |
不满足时返回 AUTHZ_DENIED。