Hakutaku

面向 Agent 客户端的 Hakutaku

在你常用的 AI 工具中使用你的 Hakutaku 第二大脑：Claude Code、Claude（网页和桌面版）、ChatGPT、OpenAI Codex、Cursor、VS Code、Windsurf 和 Gemini CLI。

连接后，你的助手会：

• 在回答有关你工作的内容前先搜索你的大脑：过往决策及其原因、人员、项目、文档、会议、任务和记忆；
• 保存你做出的决定或产出的内容，方便你之后从这些工具中的任意一个找到；
• 根据你自己的表格提供数据，必要时合并两个数据源（导出文件与 CRM、电子表格与计费应用）；
• 读取并操作你连接的应用（邮件、日历、CRM、GitHub、Slack 等），发送、发布或删除任何内容前都会先征求你的同意；
• 将耗时工作交给你的 Hakutaku Agent（附带来源的深度研究、你自己的 Agent、自动化），并在之后查看进度；
• 使用 /hakutaku:grill，一次提出一个问题，根据你的大脑中已有的信息对计划进行压力测试。

一切操作都会使用你的身份和 Hakutaku 权限。你需要拥有 Hakutaku 账号。

由 João Vitor Ribeiro de Lima 为 Hakutaku 编写。

安装

服务地址为 https://app.hakutaku.ai/api/mcp。通过 OAuth 登录：客户端会打开 Hakutaku 页面，让你批准连接。无需复制密钥。

客户端	操作方法
Claude Code	依次运行 claude plugin marketplace add hakutakuAi/hakutaku-plugins、claude plugin install hakutaku@hakutaku，然后运行 /mcp 并登录 hakutaku。安装后即可使用技能、hakutaku 子 Agent 和服务。
Claude（claude.ai、Desktop、Cowork）	Customize > Connectors > + Add > Add custom connector，URL 为 https://app.hakutaku.ai/api/mcp，然后登录。详情：targets/claude-ai。
ChatGPT	chatgpt.com/plugins > + > Add custom MCP server，URL 为 https://app.hakutaku.ai/api/mcp，使用 OAuth。详情：targets/chatgpt。
OpenAI Codex	运行 codex plugin marketplace add hakutakuAi/hakutaku-plugins，或者只添加服务：运行 codex mcp add hakutaku --url https://app.hakutaku.ai/api/mcp，然后运行 codex mcp login hakutaku。详情：targets/codex。
Cursor	添加到 Cursor，然后将规则复制到 .cursor/rules/。
VS Code	在 VS Code 中安装，或者将 mcp.json 复制到 .vscode/mcp.json。
Windsurf	将 mcp_config.json 添加到 ~/.codeium/windsurf/mcp_config.json。
Gemini CLI	运行 gemini extensions install https://github.com/hakutakuAi/hakutaku-plugins
任何 MCP 客户端	使用 https://app.hakutaku.ai/api/mcp 上的 Streamable HTTP 和 OAuth 2.1（动态注册或客户端元数据文档、PKCE）。不支持 OAuth 的客户端可使用 Hakutaku Settings > MCP 中的密钥发送 Authorization: Bearer <key>；请将密钥保存在客户端的密钥存储区或环境变量中，切勿放入要提交的文件。

首次连接后，服务会立即要求你的助手将一则简短的 Hakutaku 备忘保存到自己的记忆中，这样后续会话便能使用你的大脑，无需你再提出要求。该内容以一个区块保存，更新时会在原处替换。

此仓库包含什么

路径	内容
skills/hakutaku	核心技能：何时搜索、保存什么以及如何保存、执行外部操作前征求同意、完整的工具目录、费用和错误。只有在与你自己的工作上下文相关时才会加载；仅当任务需要时才会加载其参考资料（data、apps、agents）。
skills/hakutaku-grill	根据你的大脑检验计划。仅在你输入时运行。
agents/hakutaku.md	Claude Code 子 Agent，负责查询和保存，让原始结果留在主对话之外。
hooks/	Claude Code：在会话开始时添加简短的 Hakutaku 说明，除非你的指令中已经包含。
targets/	为各客户端生成的配置和设置说明。
server.json	官方 MCP Registry 中的条目。
benchmarks/	我们衡量此软件包的方式：触发精确度、上下文成本、任务成功率、同意和延迟。包含方法和数据。
src/ + scripts/build.mjs	为所有客户端提供同一份源代码。node scripts/build.mjs 会重新生成各客户端的文件；文件不一致时，CI 会失败。

隐私与安全

• 此插件不保存任何凭据：登录采用 OAuth，由你的客户端处理。
• 未经你同意，你的助手绝不会发送、发布、删除或花费；这些工具会先回复“需要确认”，不会做任何更改。
• 保存到你大脑中的内容仅对你可见，除非你要求分享。
• 你文档和邮件中的文本会被视为数据，而不是指令。
• 隐私政策 · 服务条款 · 支持：问题反馈或 [email protected]

参与贡献

编辑 src/、skills/、agents/ 或 hooks/session-note.sh，然后运行 node scripts/build.mjs 并提交重新生成的文件。node scripts/build.mjs --check 和 node scripts/leak-check.mjs 必须通过。

---

葡萄牙语

在你已经使用的 AI 工具中使用你的第二大脑 Hakutaku：Claude Code、Claude、ChatGPT、Codex、Cursor、VS Code、Windsurf 和 Gemini CLI。助手会在回答与你工作相关的问题前搜索你的大脑，保存你的决策或成果，利用你自己的表格数据回答问题（交叉查询两个数据源），使用你已连接的应用，并且在发送或删除任何内容前都会先征求同意；还会把耗时较长的工作交给你的 Hakutaku Agent，并通过 /hakutaku:grill 根据你的大脑已有的信息质疑计划。通过 OAuth 连接到 https://app.hakutaku.ai/api/mcp；请参阅上方的安装表格。