文档目录

使用

命令行

ail 的约定和全部子命令:Agent 和你用的是同一批。

ail 除了 desk 和 daemon 两种常驻的运行方式,其余子命令都是向 Desk 办事的命令行。会话里的 Agent 在自己的 shell 工具里敲 ail <子命令>;你在任何一台 Client 的终端里用的是同一批。

约定

启动与配对

命令 做什么
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。