agent-loft weekly downloads statistics

<p align="center"><img src="web/icon.svg" width="120" alt="agent-loft"></p>

agent-loft

多个 agent 的工作台。 把本机的 Claude Code、Codex（以后还有更多）放到同一张台面上统一管理，在网页、飞书和桌面端（macOS / Windows / Linux）随时驱动它们，进展推送到飞书、iPhone 和 Mac。

📖 完整的产品介绍和使用指南见 docs/产品介绍.md：六大核心亮点、快速上手、使用指南、命令速查、常见问题和故障排查。

由 feishu-claude-bridge 和 feishu-codex-bridge 合并而来：一个进程、一份配置，飞书和网页共用同一套会话、审批和模型切换。

理念

这里的 Loft 不是阁楼，是工作台：agent 是干活的人，agent-loft 是它们共用的那张台面。

• 多 agent，一张台面：Claude Code、Codex 各有所长，不该各开一个窗口、各记一套会话。它们在这里共用工作目录、会话列表、审批和模型切换，同一条会话里随时换人接手，各自的上下文都保留着。
• 统一管理，而不是再造一个 agent：agent-loft 不自己做模型、不改 agent 的行为，只负责把官方的 agent 接进来、管起来。新的 agent 接一个驱动就能上台。
• 人在哪，台面就在哪：电脑上用网页，手机上用 PWA 或飞书。同一个会话、同一个授权请求，在哪个渠道处理都行，其他地方自动同步。
• 跑在你自己的机器上：代码、凭据和会话都留在本机，agent-loft 只是一层安全的遥控。

Logo 就是这个意思：一大两小几颗星（多个 agent）站在同一张台面上。

六大核心亮点

	亮点	说明
🤖	同时管理多个 agent	Claude Code（官方 Claude Agent SDK）和 Codex（官方 codex app-server）共用会话列表、工作目录和授权。新建对话时选专家：内置的 Claude Code / Codex，或者自己配的专家
🧑‍🏫	专家	自己配专家：选引擎、写提示词，定它能做什么（只能联网 / 读文件 / 改文件 / 跑命令），挂哪些技能和 MCP，能把活派给哪些子智能体。新对话、定时任务都能选
🔀	飞书机器人灵活绑定 agent	机器人数量不限，每个机器人可以直接勾选内置或共享专家，并选择默认专家（可在会话里切换）。网页上扫码就能创建，改完立即生效；由服务端主动连向飞书，家里没有公网 IP 也能在外面用
🔗	飞书续接 Web 任务	飞书里发 /web 接上一条 Web 会话，或者在网页聊天右上角「更多」或侧栏会话右键菜单里选「在飞书继续」。之后回复、授权、提问都发到飞书，发 /detach 回来
💬	微信 ClawBot	设置 → 账号里用微信扫码，就能在微信里和 agent 聊天、回数字处理授权和提问，网页上是同一条对话。每个人连自己的微信。微信限制较多，适合发起任务和接收回复，详见下面的说明
🖥️	完整的 Web 工作台	流式回复、附件、语音输入、模型和思考程度切换、上下文占用、从任意回复分叉、按项目分组的侧栏、搜索会话、全部设置，电脑和手机（PWA）都能用
🔔	飞书 + 苹果系统推送	除了飞书消息，Web 会话还能推送到 iPhone、iPad 锁屏和 Mac 通知中心（标准 Web Push，不需要开发者账号），图标上显示未读数
🗂️	桌面端同时接入多台设备	桌面端（macOS / Windows / Linux）同时连多台服务器，菜单栏 / 托盘一眼看完各台的额度、待处理和运行中的会话

能做什么

• 多个 agent：Claude Code、Codex。两个 agent 共用工作目录，能看到对方改过的文件，但聊天记录各自独立。
• 多个飞书机器人：设置 → 飞书 →「可用专家」直接勾选内置或共享专家，并选择「默认专家」。只勾一个共享专家即可专用，不用再勾选底层 Agent；每个人绑定自己的账号后，直接私聊就是这个专家，使用各自的记忆和工具。机器人能在 Web 上扫码创建（Lark 国际版用「手动添加」），改完配置立即生效，不用重启。
  • 群聊里要 @ 机器人；不同话题是各自独立的会话；支持文字、富文本、图片、文件、语音和视频。
  • 思考和工具调用显示在实时刷新的过程卡片里，最终回复是普通消息。
  • 陌生人发消息会拿到配对码，在设置页批准后才能使用；每个机器人单独授权。
• Web 工作台：电脑和手机都能用，界面参照 ChatGPT。
  • 回复逐字显示，markdown 和代码高亮，思考过程和工具调用可以折叠；每条回复下方显示用时、费用和完成时间，可以复制，也可以「从这里分叉」成一条新会话（原会话不动）；自己发的消息也能一键复制。
  • agent 做多步骤的活时列的任务清单显示在输入框上方，看得到做到第几项、正在做哪一项。
  • 授权卡、提问卡直接在页面上点。
  • 附件：点击输入框的「+」直接上传，也可以粘贴、拖拽，手机上可以拍照；可以预览和下载。附件存在服务端的专用上传目录里，发出去的都收进资料库，开新会话、切换目录也不删；删除会话时立即清理。
  • 回复里提到的文件（链接、路径、正文里的绝对路径，Claude 和 Codex 都认）点一下就能预览：图片、PDF、音视频、markdown、代码和文本直接看，网页渲染出来看（也能切到源码），其它的下载。Codex 的 visualize 插件画的图表（回复里的 visualize{"path":…}）和官方客户端一样直接嵌在回复里。网页和图表放在沙箱里显示，碰不到登录态和本站接口。
  • 回复里的图：专家和 agent 在回复里写 ```chart（一段 JSON：折线、面积、柱状、饼图、散点）就画成可悬停的图，可以切到表格看具体数字；写 ```mermaid 画流程图、时序图等。跟着系统深浅色走，图库用到时才加载；飞书上 chart 换成表格。写法自动附在每个专家（包括内置的 Claude Code、Codex）的提示词里。只认这条对话里 agent 回复写过的路径；私钥、.ssh、.env、各种凭据和 agent-loft 自己的配置数据一律不给看。
  • 回复里的相册：agent 用 ```album JSON 描述多张本地照片，网页显示缩略图网格，每页 12 张、懒加载；点开大图可左右切换，也支持方向键和 Esc。可附名称、拍摄日期、说明和查询总数，每个相册最多 200 张；飞书显示简短摘要。写法自动附在所有专家的提示词里，图片沿用会话文件权限。
  • 聊天右上角「更多」和侧栏会话右键菜单共用分叉、重命名、在飞书继续、删除操作，按会话类型和可用机器人显示。
  • 语音输入：用浏览器自带的语音识别（Chrome / Edge / Safari，需要 HTTPS）。
  • 新对话页：点大标题里的目录名，在固定高度的目录弹窗里逐层选工作目录，也能新建文件夹；输入框上方选专家，鼠标停在专家上看简介，右下角选模型和思考程度。对话从头到尾一个专家，要换专家就新建对话；模型和思考程度随时可换。
  • 输入框里的小圆环显示上下文窗口占用；模型按钮显示实际的模型和思考程度（如「Opus 5.5 high」）。
  • 滚动和 ChatGPT 一样：发出的问题顶到最上面、下面留白，回复长到屏幕底部才跟着往下滚；回复过程中自己滚动了就不再自动滚，下次发消息再恢复。
  • 定时发送：右上角「更多」→「定时发送」，默认排在 5 小时额度重置后 5 分钟（弹窗里提示 5 小时 / 7 天额度的重置时间），由服务端到点发出，关掉页面也会发。适合额度用完、要等刷新才能接着干活的时候。
  • 侧栏直接显示各个文件夹，Web 会话按工作目录归类（目录可以拖动排序，右键可置顶；排好的顺序跟着账号走、各设备一致，新消息不会打乱），飞书会话按机器人分组，微信的当前与历史会话按账号分组，两者都能展开 / 折叠并记住状态，收起时仍显示运行中和待处理提示，展开即可查看历史会话。渠道分组行右侧始终显示飞书或微信的静态图标，Web 页面不提供这些分组的新建会话入口。项目名、渠道分组名和有分叉的会话后面有个小三角，点一下折叠 / 展开（分叉折叠后显示「N 个嵌套会话」）；分叉出来的会话缩进挂在原会话下面，用一条细线连着；标题放不下时尾巴淡出；Web 和飞书会话都先用首条消息命名，再同步 agent 自动生成的标题，旧飞书会话会从历史记录补名，双击可手动重命名；鼠标移到会话上，行尾显示对应的专家图标；定时任务的时钟图标始终放在最右侧。
  • 搜索：侧栏「搜索」弹窗，搜全部会话的标题、目录名和聊天内容（不开记忆也能搜），可以按专家筛；电脑和手机上弹窗都固定高度，结果在内部滚动，手机上从底部展开；↑↓ 选、回车打开。
  • 侧栏菜单：项目上方的「更多」支持点击或鼠标悬停展开，设置入口也在这里。「编辑侧边栏」可勾选直接显示的菜单、拖动调整顺序，未勾选的收进「更多」；配置跟着账号走，电脑和手机共用。
  • 会话页顶部标题前是专家的头像，PC 端头像与会话名称字号一致（15px）；鼠标停上去或点一下，看专家的说明、模型、能力、当前工作目录和本会话 Token 用量。
  • 附件可以直接拖到聊天区任意位置上传。
  • 回复过程中接着发的消息排队，标着「排队中」，隐藏底部的复制和回退按钮，上一条回复完自动接着处理；点「撤销并编辑」图标把排队消息放回输入框；点「打断并发送」停掉正在进行的回复、马上处理这条；点停止则连排着的一起取消（标「没有发出」）。
  • 用户消息的复制按钮后有「回退到此处」图标：把这条消息及附件放回输入框，并删除它及之后的聊天内容，重新发送时从之前的上下文继续。
  • 太长的消息先收起，点「展开显示」看全文；对话里有至少 3 条用户消息时，右侧显示快速定位尺，电脑上鼠标移入查看消息开头、点击跳转；手机上手动滚动时显示短轨道，按住拖动可预览问题和位置，松手跳转，停止操作约 1.6 秒后隐藏。
  • 回复底部的 token 数自动按大小显示为 K、M 等单位。
  • 项目右键（触屏长按）可「删除项目…」：二次确认后删除文件夹及全部文件、子目录和关联会话，同时清理附件、资料库文件和定时发送；目录选择器里也可删除空文件夹。工作区根目录、包含其他用户会话的目录不能删除，Agent 自己保存的原始会话记录仍保留。
  • 侧栏按页加载：每个项目目录和飞书机器人分组先显示 5 条，点「展开显示」每次再拉 10 条。
  • 项目、飞书和微信分组可混合拖拽排序，渠道分组可以放在项目前面或项目之间；右键（触屏长按）可置顶、上移、下移或按最近活跃重排。顺序按账号保存，刷新、换设备后保留，新消息不会改变已排好的位置。
  • 侧栏底部显示 Claude / Codex 的订阅额度（5 小时 / 7 天窗口，以及多久后重置）；关了额度查询就整块不显示。
  • 专家信息弹窗底部显示当前会话累计消耗的 Token 分布（输入 / 缓存写入 / 缓存读取 / 输出，Claude 还有按 API 价格估算的费用）。设置入口在侧栏的「更多」里。
  • 设置 → 用量：按日 / 月 / 年（默认按月）统计 token 和金额，有每天（每月）的柱状图，按 agent、模型、用户（管理员才有）分开看；成员只看到自己的。管理员还可查看服务端本机直接使用的 Claude Code、Codex 桌面端和 CLI 用量，和 Agent Loft 的用量分开显示、避免重复计算。金额都是按 API 价格算的参考值：Agent Loft 的 Claude 用它自己报的费用，Codex 和直接用的 Claude Code 按模型单价 × token 估算（OpenAI 单价来自 LiteLLM 公开价格表，内置快照、联网时每天更新）。Agent Loft 的账从 0.2.34 开始记录；本机直接使用的用量可回溯已有会话记录。
  • 「添加到主屏幕」后当 App 用；切到后台再回来会自动重连，补上错过的内容。
  • 前端资源按指纹长缓存：再次打开不用逐个向服务端确认，升级或改了文件后刷新页面自动换新。
  • 手机顶栏采用实色圆形按钮和「专家＋更多」胶囊按钮组；从左边缘右滑展开侧栏，在侧栏或遮罩上左滑收起，短滑会回弹。消息底部操作栏与下一条消息之间留 4px。
• 网页多服务器切换：在 设置 → 服务器 添加其他 agent-loft，再点「授权」到对方页面确认，侧栏左上角通过名称和紧随其后的箭头切换，不显示服务器图标，嵌入桌面端时隐藏此入口；各台分别登录，切走后保持连接，列表显示待处理数和运行状态，刷新后保留选择。几台需使用同一主域名下的 HTTPS 地址（例如 mac.example.com、nas.example.com）。在外层页面开启系统通知后，各台的提醒都能推到同一个主屏幕 App，点通知自动切到对应服务器和对话。见使用指南。
• 系统通知：Web 会话回复完成、出错、需要授权或提问时推送到手机 / 电脑（设置 → 系统 → 系统通知 → 「在此设备开启通知」，可以发测试通知）。飞书会话由飞书提醒，正在前台看着的会话不推。需要 HTTPS 访问，iPhone 需 iOS 16.4+ 且从主屏幕图标打开。
• 跨渠道同步：飞书里的会话在 Web…