SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI编程工具agentmako

agentmako

agentmako 是一个本地优先（local-first）的代码库智能引擎，面向 Codex、Claude Code、Cursor 等 AI 编程工具。它通过 MCP 服务器为编码智能体提供结构化的上下文包、代码与数据库 schema 事实以及诊断信息，数据由本地 SQLite 存储支撑。核心目标是让智能体在修改代码前先理解项目：哪些文件重要、哪些路由、符号、数据表、诊断和既有发现相关、接下来该读什么。主要工具包括 reef_ask（跨代码、数据库、发现、诊断、新鲜度与字面证据的项目查询）、context_packet（确定性的上下文扩展）、mako_help（可查询的工作流指引）等。支持 TypeScript、ESLint、Oxlint、Biome 及暂存 git 诊断摄入，可热重载 .mako/rules YAML 规则包，并可选接入 Postgres/Supabase schema 快照与只读数据库检查。所有关键部分都在本地运行，无需托管服务。要求 Node.js 20 或更高版本。采用 Apache-2.0 许可。

访问官网

工具介绍

用途

agentmako 是面向 AI 编程工具的本地优先代码库智能引擎。它让 Codex、Claude Code、Cursor 以及本地 harness 之类的编码智能体，在编辑代码之前先理解项目。Mako 会索引仓库，构建由本地 SQLite 支撑的事实数据，跟踪诊断与评审笔记，并以有证据支撑的方式回答问题，而不是让智能体去编排庞杂的工具链或用原始 grep 反复重新发现一切。

它聚焦于编码智能体工作的“第一英里”：哪些文件重要？哪些路由、符号、数据表、诊断和既有发现是相关的？智能体接下来应该读什么？

主要能力

  • 面向编码智能体的 MCP 服务器：agentmako mcp
  • 本地仪表盘：agentmako dashboard
  • 主要项目查询：reef_ask，覆盖代码、数据库、发现、诊断、指令、新鲜度与字面检查
  • 可查询的工作流定位：mako_help
  • 确定性的上下文扩展：context_packet
  • 工具结果上的 _hints，让智能体获得针对具体结果的下一步提示
  • 中央 MCP 注解，使客户端能够区分安全读取、实时读取与本地状态变更
  • 紧凑的循环/回退工具：reef_status、reef_verify、reef_impact、live_text_search、lint_files 和 tool_batch
  • Reef Engine 在已索引、工作树和暂存状态下生成事实与发现
  • Reef 约定提取，针对认证守卫、运行时边界、生成路径、路由模式与 schema 使用
  • TypeScript、ESLint、Oxlint、Biome 以及暂存 git 诊断的摄入
  • 热重载 .mako/rules YAML 规则包，包括通过 canonicalHelper 实现的原始跨文件辅助函数绕过规则
  • 可选的 Postgres/Supabase schema 快照与只读数据库检查
  • 本地数据库评审评论，用于记录表、RLS、触发器、发布、订阅与复制的笔记
  • 用于重复评审工作的召回、确认与智能体反馈
  • 一切重要内容均在本地运行，无需托管服务

使用方式

要求 Node.js 20 或更高版本。确认 CLI 可用后，应能看到配置与本地 API 服务的绿色检查。从源码构建的说明见仓库底部。

快速开始

  1. 接入真实项目：进入希望 Mako 理解的项目，执行接入与索引命令。首次运行时使用 --no-db，先让代码智能路径跑通，再添加数据库范围。
  2. 确认 Mako 能看到项目：运行一次真实的 Reef 查询。如果返回有证据支撑的答案、事实、发现或后续查询，说明核心设置已正常工作。reef_ask 会规划代码、数据库、持久化发现、诊断与精确字面证据。应用流程类问题偏向文件、路由和发现证据；RLS/schema 类问题偏向数据库事实与评审评论。也可直接检查项目经验规则。
  3. 配置 MCP 客户端：将配置加入 MCP 客户端配置，重启客户端并确认 mako-ai 服务器启动。在智能体中默认使用 reef_ask。紧凑的起始工具面包括：reef_ask（跨代码、数据库、发现、诊断、新鲜度与引用字面检查的项目问题）、reef_status（维护中的问题、变更文件、过期诊断与 watcher/schema 健康）、reef_verify（针对诊断新鲜度与未闭环事项的完成门禁）、reef_impact（变更文件的影响范围与约定风险）、mako_help（带有预填参数的有序工作流配方）、live_text_search（针对当前磁盘的精确正则/glob 清单）、lint_files（有界诊断与 .mako/rules 发现）、tool_batch（相互独立的只读后续操作）、tool_search（仅在紧凑工具面指向具体需求时，用于发现专门的路由、图、DB、发现、刷新或上下文扩展工具）。
  4. 可选：使用智能体插件。纯 MCP 可在任何地方工作，但捆绑插件会添加 Mako 专属技能并包含相同的 agentmako mcp 接线。使用前需已安装 Claude Code、PATH 上有 Node.js 20+（插件会运行 npx -y agentmako mcp，自动获取已发布的 agentmako 包，无需单独全局安装），且目标项目已通过 agentmako connect 接入。插件暴露的技能包括：/mako-ai:mako-guide、/mako-ai:mako-discovery、/mako-ai:mako-trace、/mako-ai:mako-neighborhoods、/mako-ai:mako-graph、/mako-ai:mako-database、/mako-ai:mako-code-intel、/mako-ai:mako-workflow。当希望 Claude Code 加载 Mako 专属指引（该调用哪些工具以及如何解读结果）时使用插件。
  5. 可选：启动仪表盘。在目标项目中执行后，会启动本地 API、harness 服务与 Web 仪表盘。
  6. 可选：添加 Supabase/Postgres 感知。Mako 没有数据库也能工作，只有在代码智能跑通后再添加此项。支持一次性交互式设置，也支持在 CI 或脚本化设置中使用环境变量。之后刷新并验证本地 schema 快照。交互模式下默认将数据库密钥存储在操作系统钥匙串中，项目配置存储的是引用而非明文 DB URL。

日常使用循环

在目标项目中执行日常循环；针对暂存评审检查；针对数据库评审笔记。

从源码开发

如果想修改 Mako 本身，可以克隆并构建，而不是从 npm 安装。需要 Node.js 20 或更高版本，以及 Corepack（通过 corepack enable 启用，现代 Node.js 已包含）。npm link ./apps/cli 使源码构建的 CLI 以 agentmako 形式出现在 PATH 上，替换任何全局 npm 安装。拉取更改后重新运行 corepack pnpm run build。若要恢复为已发布版本：npm install -g agentmako。

适用场景

  • 编码智能体在编辑前需要快速理解项目结构、关键文件与相关符号、路由、数据表的场景
  • 需要跨代码、数据库 schema、诊断与既有发现进行有证据支撑查询的场景
  • 需要跟踪诊断、评审笔记与重复评审工作的场景
  • 希望在本地运行、无需托管服务的代码库智能分析场景

限制

  • 要求 Node.js 20 或更高版本
  • 需要 Node.js 20+ 在 PATH 上（使用插件时）
  • 数据库相关能力为可选项，且 Postgres/Supabase 检查为只读
  • 交互模式下数据库密钥默认存储在操作系统钥匙串中，项目配置存储引用而非明文
  • 许可为 Apache-2.0，详见 LICENSE
  • 其他功能细节、价格与平台支持情况暂未提供

同类工具

查看分类