文档目录

入门

简介

aiL 是什么、解决什么问题、由哪几部分组成。

aiL 是一套个人 Agent 系统。你只做三件事:提出、决定、验收。其余的活由你自己电脑上的编码 Agent 去做,系统负责派发、流转、评审、合入和记录。

名字和域名来自同一句话:art is Long,出自拉丁谚语 Ars longa, vita brevis。中文里与它相应的是《庄子》的「吾生也有涯,而知也无涯」:生有涯,所以长活不该占着人。

它解决什么

同时用几个编码 Agent、几台电脑干活的人,很快会遇到同一组问题:

aiL 把这些收到一处:一个 Agent Desk 连着你的每台电脑,每台电脑上有一个 Daemon 替它启动 Agent 会话。你对 Router 说一句话,系统照工作流把事情做完,只在需要你决定或验收时找你。

由什么组成

每个平台只有一个可执行文件 ail,它有三种用法:

用法 是什么
ail desk Agent Desk:界面、引擎和数据库。每个用户一个
ail daemon Client Daemon:每台电脑一个,主动连向 Desk
ail <子命令> 命令行:Agent 在会话里、你在终端里向 Desk 办事的入口

Agent 程序称为 Harness。aiL 经 ACP(Agent Client Protocol)启动它们,现在支持五个:claude、codex、dsh、pi、antigravity。在引擎和界面看来,它们启动出来的会话都是同一个 Worker。

做什么、怎样流转,由 Git 里的插件决定:角色、工作流、界面和仓库登记都是文件,改完就生效,不用换可执行文件。

一件事怎样走完

  1. 你对 Router 说要做什么。Router 只判断这是什么意图、归哪个仓库,然后派发。
  2. 引擎建立一次运行,在角色绑定的那台电脑上启动 Worker。
  3. Worker 在自己的 Git worktree 里干活。要你拿主意时,它推一份 Review Report,你在 Desk 上回答。
  4. 带评审关口的步骤由另一个 Worker 评审。通过后引擎合入改动、归档任务、记一条 Journal。
  5. 运行结束,带着执行报告留在看板上,等你归档。

每一步的规则见工作流与引擎。

界面

Desk 的界面是一个浏览器里的桌面:

窗口窄于 1024 像素时,三栏变成三个可以横滑切换的整页,手机上也能用。

现状

aiL 仍在开发中,二进制和源码尚未公开发布。这里的文档描述它现在的设计和用法。

从哪里读起:先读概念认识名词,再读方法论了解它为什么这样设计。