跳转到内容

智能体

ffgit与你已有的编程智能体协同工作:它启动已安装的Claude Code和Codex CLI,并使用你自己的账号登录。ffgit不提供模型,也不转售token。对话本身请参阅Chat。

  1. 选择Agents → Start agent task…,或在分支菜单中选择Start agent task…。Chat中会以草稿形式打开一个新对话。

  2. 写下任务,选择智能体、登录账号、模型和推理强度,以及在当前工作树还是新工作树中工作。Templates可以用十二个现成提示词之一填充任务——例如一个保持git status不变的审查任务——也可以使用你自己的提示词。

  3. 启动任务。⌘↩︎:启动任务并保留草稿,这样同一任务可以再交给另一个智能体或模型,每个都在一个以下一个可用名称命名的新工作树中运行。

新工作树会获得一个以智能体和任务命名的空闲分支,位于主检出目录旁边的文件夹中。从分支菜单启动时,对话会在已检出该分支的工作树中工作,或在一个分支从它出发的新工作树中工作;Stack on会让这个新分支成为堆叠分支。

如果安装了多个Claude Code或Codex,ffgit会运行其中能正常工作的最新版本。当它落后于最新发布版本时,New chat会给出提示,Update会在Terminal中运行该智能体自己的更新。

为智能体创建的新工作树可以先运行项目的worktree setup(工作树初始化):从主检出目录复制被忽略的文件、运行命令并检查路径。只有在你审核过每一步之后它才会运行,在后台执行并可Cancel,完成后智能体才会启动。

  • 初始化配置可以保存在On this Mac(本机),或In the repository(仓库中),即.ffgit/worktree-setup,以便提交和共享。
  • 编辑器会从项目已为其他工具准备的配置开始——Codex的本地环境、Cursor的worktrees.json、Conductor的初始化脚本、Claude Code的.worktreeinclude——或者根据锁文件和被忽略的.env文件推测。
  • 各步骤可以通过$FFGIT_SOURCE_PATH和$FFGIT_WORKTREE_PATH找到主检出目录和工作树。

工作树菜单中的Project actions…保存命名的命令(例如Run tests),以及在你结束(settle)对话时运行的收尾脚本。在Chat中,可以从对话的菜单在其工作树中运行这些命令,每个命令都是对话下方抽屉中的一个标签页。

名称以[server]结尾的操作是开发服务器:它会在$PORT和$FFGIT_PORT中获得一个空闲端口,只要该端口空闲,每次都是同一个,因此两个工作树的服务器永远不会冲突。服务器开始监听后,它的标签页会显示http://localhost:<port>地址,并提供Open、Copy和Restart。

对于Claude Code,ffgit读取Claude Code为每个运行中的会话保存的状态文件(~/.claude/sessions/<pid>.json):工作中、等待权限或输入、空闲,或一轮结束后已有回复就绪。从ffgit启动的运行还会说明它在等待什么——Needs permission、Asking a question、Waiting for you、Rate limited、Error等——这些信息来自仅在会话内生效的钩子,从不写入你的设置文件。由ffgit运行的对话会通过自己的数据流报告状态。

Agents有两个标签页:

  • Sessions:在同一个列表或看板中展示ffgit的运行、实时Claude Code会话,以及发现的Codex和Claude Code会话,分为Needs you、Working、Ready、Errors、Idle。可按项目、智能体和状态筛选,并把范围缩小到某个工作树、项目、工作空间或所有项目。双击即可在Chat中打开对话。
  • Activity:问题、已就绪回复和失败的统一收件箱,提供Needs you、Ready for review、Errors和All activity视图。导航栏和铃铛图标会显示当前窗口所在工作空间的未读消息串数量。

Jump to…(Cmd/Ctrl+K)可以用任意顺序的关键词查找对话、项目、工作树、分支和菜单操作;在你允许后,还能按消息内容查找对话(见查找对话)。Waiting for you(Cmd/Ctrl+Shift+I)只列出等待你回答的对话,等待最久的排在最前。

侧边栏会在项目树中显示智能体:每个项目上的状态计数、每个工作树上的状态图标,以及其下最多三行智能体条目。工作树按状态分组:活跃的排在最前,然后是Done(所有提交都已在默认分支中)和Unavailable。

开启Notify me when a chat needs me(默认关闭)后,如果ffgit在后台时有对话进入等待或已完成,就会弹出macOS通知,Dock图标会显示正在等待的对话数。你可以选择通知的类型(Needs you、Finished、Failed、Setup)、提示音,以及通知中是否写出任务内容。ffgit处于活动状态时,窗口会以浮动提示(toast)显示同样的内容。

ffgit在Terminal中启动的智能体会先获得一个任务基线(task baseline):即那一刻工作树的状态,仅以Git对象保存,不产生任何提交、引用、贮藏或索引改动。Compare with task start…会显示Since task started、Current uncommitted changes和Commits since launch base,措辞为观察到的改动,从不说成是智能体所做。

会话详情会显示其对话在这台Mac上保存的所有内容——对话记录、草稿区和任务输出、图片和计划,以及智能体工具为它创建的工作树——并分为可释放(下次运行时会重新写入)、谨慎释放和保留三部分。

  • Agents列表会显示每个对话的大小和每个项目的合计,以及它计入的智能体工作树。
  • **Clean up chats…**会列出早于你所选时长的对话,逐个删除它们或释放其空间,并跳过正在运行的对话,以及文件被某个进程占用的对话。
  • **Free build output…**会把智能体工作树中的构建产物和依赖包移到废纸篓;.env、其他被忽略的文件以及工作树本身都会保留。
  • Cleanup中的Remove agent worktrees by themselves会按你选择的规则移除闲置的智能体工作树,并先创建恢复副本。