用途:通过 CLI 命令控制 AiTer 终端客户端,实现多项目与多智能体的编排。
前提:AiTer 桌面应用必须处于运行状态;命令通过 Unix socket 通信,路径为 /tmp/aiter-{uid}.sock。所有命令输出 JSON,可用 jq 提取字段。
主要能力: 项目管理:aiter project list 列出项目;aiter project create "<name>" "<path>" 创建项目(非 Git 仓库时会初始化);aiter project open <project-id> 聚焦项目。 终端管理:aiter terminal list [--project <project-id>] 列出终端;aiter terminal create <project-id> 创建终端(默认运行 minto,可用 --skip-startup 跳过);aiter terminal write <terminal-id> "<text>" 写入文本并回车执行;aiter terminal read <terminal-id> [--lines N] 读取缓冲输出(会剥离 ANSI 转义码);aiter terminal kill <terminal-id> 优雅关闭终端。 文件服务器:aiter server start <project-id> 启动 HTTP 服务用于 HTML 预览;aiter server url <project-id> "<relative-path>" 获取文件 URL;aiter server stop <project-id> 停止;aiter server stats 查看统计。aiter status 返回项目、终端与文件服务器概览。
智能体通信协议:子智能体通过向 Meta Agent 终端写入结构化消息汇报,格式如 [PROGRESS:<source-terminal-id>]、[QUESTION:...]、[DONE:...]、[ERROR:...]。派发任务时需在提示中包含子终端 ID、Meta 终端 ID 及通信协议说明。
常见模式:创建项目后创建终端并等待初始化,再写入任务;轮询各终端输出检查 [DONE] 或 [ERROR] 标记;批量创建关联项目。
限制与错误处理:AiTer 未运行时返回连接错误;参数缺失或终端不存在时返回对应错误。建议先检查 success 字段,读取时用 --lines 限制数据量,对瞬时连接错误实现重试,轮询间隔 5 秒以上,任务完成后清理终端。具体收费、平台支持等信息暂未提供。