智能体与Chat

ffgit与你已有的编程智能体协同工作：它启动已安装的Claude Code和Codex CLI，并使用你自己的账号登录。ffgit不提供模型，也不转售token。

1. 选择Agents → Start agent task…。Chat中会打开一个新对话。

2. 选择Claude Code或Codex、模型，以及在当前工作树还是新工作树中工作。Templates可以用十二个现成提示词之一填充任务——例如一个保持git status不变的审查任务——也可以使用你自己的提示词。

3. 启动任务。⌘↩：启动任务并保持表单打开，这样同一任务可以再交给另一个智能体或模型，每个都在一个以下一个可用名称命名的新工作树中运行。

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

每次运行都会在该会话中获得ffgit的MCP工具。ffgit会跟踪运行是否仍在进行、以何种方式结束、其工作树改动了多少文件，以及其HEAD新增了多少个提交。

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

Agents有两个标签页：

• Sessions：在同一个列表或看板中展示ffgit的运行、实时Claude Code会话，以及发现的Codex和Claude Code会话，分为Needs you、Working、Ready、Errors、Idle。
• Activity：问题、已就绪回复和失败的统一收件箱，提供Needs you、Ready for review、Errors和All activity视图。导航栏和顶栏会显示未读消息串的数量。

侧边栏会在项目树中显示智能体：每个项目上的状态计数、每个工作树上的状态图标，以及其下最多三行智能体条目。

Chat列出项目的对话。打开一个对话即可查看其内容，这些内容读取自这台Mac上智能体自己的对话记录：消息、与结果折叠在一起的工具调用、按需显示的推理过程，以及实时到达的新内容。

通过Start agent task…（启动智能体任务）或Resume in ffgit启动的智能体在Chat的终端中运行，你可以在其中输入内容来回复它们。⌘F可在其中查找文本，包括滚动历史。

会话详情会显示其对话在这台Mac上保存的所有内容——对话记录、草稿区和任务输出、图片和计划——并分为可释放（下次运行时会重新写入）和保留两部分。Agents列表会显示每个对话的大小，以及每个项目的合计。