适合谁
- 需要在编码代理会话中保持任务连续性的开发者
- 希望本地存储并可能手动审查任务状态的团队
- 熟悉 Claude Code、Cursor 或 Codex 并希望提高一致性的人
A
68FMRS · C
Agentpack 是特定领域的 MCP 服务器，面向注重隐私的开发者，他们希望各种本地 AI 代理接替者之间的任务状态具有延续性。它提供核心概念，如任务护照与检查点，但官方文档未提供完整工具清单，这限制了无记录的初始集成。
Agentpack 是一个本地优先的 MCP 服务器，为 AI 编码代理保留任务状态。它在你的仓库中维护一个可审查的任务账本（.agentpack/），记录目标、决策、死胡同、验证证据和检查点。代理通过 MCP 工具在会话期间记录重要状态，随后的会话（无论是同一代理压缩后、不同客户端还是未来的你）都会加载该状态并从中断处继续。Agentpack 还生成项目指令（AGENTS.md、CLAUDE.md、Cursor 规则）以指导代理何时加载和记录状态，并提供 CLI 供人类检查和手动交接。核心功能包括任务护照、任务门控（通过 hook 警告或阻止越界编辑）和预算上下文输出。
安装接入
需要 Node.js >= 20。全局安装 agentpack-cli。然后进入仓库：agentpack init 初始化；agentpack install claude --write 或 agentpack install codex/cursor 设置客户端。重启或重新连接客户端后即可使用。可用 agentpack doctor 验证设置。
选型与风险
不适合谁
- 需要云同步或协作功能的用户（本地优先）
- 没有 Node.js 20+ 或希望使用单个二进制文件可能更专注的用户
- 希望与现有问题追踪器或项目管理工具集成 （Agentpack 不提供此类集成） 的用户
所需权限
- 访问本地仓库文件系统（.agentpack/ 目录）
- 通过 npm 全局安装软件包（agentpack-cli）
- 根据配置可执行 git hooks（任务门）
风险与副作用
- 审阅欠佳或配置错误可能导致状态记录不准确或错失上下文
- 本地文件可能被意外修改或删除
- secret 值的尽力脱敏，但并不保证完整
- 任务门可能导致代理被阻止，如果配置不当
常见排障
- 运行 agentpack doctor 检查设置。
- 确保 Node.js >= 20。
- 验证并重启客户端以加载 MCP server。
- 以 agentpack resume --preset agent --query "topic" 等方式检查 CLI 状态。
使用场景
处理不稳定的测试或重构，任务耗时较长
在 Claude Code、Cursor、Codex 或其他 MCP 客户端间切换任务
几天后需要继续任务
在 monorepo 的多个部分上并行工作，并保持任务焦点