AIE

aie 是一个本地优先的 AI Engineer Gateway。它在用户电脑上直接连接飞书长连接事件通道，把唯一绑定用户的私聊消息交给本机 Codex，并把结果发回同一个用户。

普通消息和交互卡片按钮都通过飞书长连接到达本地 Gateway，不需要公网域名、Webhook、内网穿透、云端服务或中心 Relay。项目代码、Codex 登录状态、prompt、会话路由和审批状态都保存在用户电脑上。

当前能力

• 管理多个本地项目和项目内 Codex 会话。
• 通过回复原消息、/send（中文 /发送）或飞书独立焦点把消息投递到明确会话。
• 每个会话任务收到后立即独立运行，不设置项目级或全局并发上限。
• 使用 codex app-server 保持上下文并双向处理审批，旧版 CLI 可降级到 codex exec。
• 在飞书卡片或本地终端处理命令、文件修改和额外权限审批。
• 按“会话覆盖 -> 项目默认 -> 全局默认 -> 本机安全上限”管理 Codex 权限。
• 查看和清除“本会话允许”产生的临时授权。
• 后台运行、唯一用户绑定、定向或全部停止任务、任务状态持久化和结构化日志。
• 飞书焦点与桌面 CLI 默认上下文独立，互不干扰。
• 为每个项目独立配置飞书多维表格，串行读取开放需求；每条需求从项目当前检出的本地分支创建隔离的功能分支和 Git worktree，完整实施并复查修复后提交、推送到 origin。
• 为每个项目独立配置 Bug 多维表格，串行检查“适用项目”包含当前项目且尚无同名会话的 Bug。

需求表格配置归属于当前选中的项目。不同项目可以绑定不同 Base 或数据表；配置支持直接粘贴飞书链接，也兼容纯文本 token，飞书自动转换成 Markdown 的链接同样支持：

/需求 配置 <飞书多维表格/Wiki链接>
/需求 配置 <app_token> <table_id>
/bug 配置 <飞书多维表格/Wiki链接>
/bug 配置 <app_token> <table_id>

快速开始

要求 Node.js 20+，并已安装、登录 Codex CLI。

npm install
npm run build
npm install -g .

aie init
aie codex test
aie feishu config
aie feishu test
aie project add my-project /absolute/path/to/project
aie bind
aie start

随后在飞书中私聊机器人并发送 /bind（中文 /绑定）。绑定成功后，发送 /workbench（中文 /工作台），直接点击项目和会话卡片即可开始对话。所有飞书内置命令都必须以 / 开头；普通文本始终作为 Codex 消息处理。

aie status
aie permission presets
aie logs --follow
aie logs --type audit --follow
aie logs --list
aie stop

每次 Gateway 启动会创建独立的 logs/runs/<run-id>/ 日志目录。Codex 提示词、事件、审批、命令、文件变更和最终结果写入 audit.jsonl，并按项目与会话拆分到 sessions/；同一会话的跨运行时间线保存在 logs/sessions/。

所有命令都支持规范帮助：

aie -h
aie start --help
aie project -h
aie project add -h
aie session -h
aie session new --help
aie context -h
aie task -h
aie task stop -h
aie permission -h
aie permission set -h
aie codex -h
aie codex run -h
aie feishu -h
aie feishu config -h

飞书中发送 /help 或 /帮助，可在一张卡片中查看飞书端支持的全部中英文命令。CLI 与飞书是两套独立命令面，帮助内容不会混在一起。

文档

• 完整使用说明
• 架构与实现方案
• 本地开发与调试
• 飞书交互卡片配置
• Codex CLI 命令清单

验证

npm run check
npm run build
npm pack --dry-run

Requirement processing commits and pushes each completed feature branch, then removes its temporary Git worktree. The local and remote feature branches remain available for review; switch the main workspace to the feature branch when needed.