agentmako

agentmako is a local-first MCP server designed to provide coding agents such as Claude Code, Codex CLI, Cursor, and Cline with a live, queryable map of a code repository. Its primary function is to keep elements like code, routes, schema, diagnostics, project rules, findings, and freshness state accessible for various MCP clients, supporting agent workflows that require up-to-date and trustworthy project context.

The tool features an engine called Reef, which acts as a durable fact and finding layer. Reef continuously tracks changes within the codebase, records failures, reviews, and determines the freshness of evidence using content hashes rather than relying on file modification times or clocks. This approach ensures that agents receive only evidence-backed claims, with the system explicitly designed to avoid providing unsubstantiated or stale information. Key data such as routes, imports, symbols, schema details, instructions, and rule-pack hits are maintained as typed local evidence, while findings like known issues, cross-file risks, open loops, and reviewed decisions persist across sessions.

agentmako supports agent workflows through features like context_packet, file_preflight, and reef_diff_impact, which allow for efficient, one-call guidance based on the current state of the codebase. The tool operates as a background daemon, monitoring edits and refreshing scoped diagnostics automatically. Its "trust contract" principle emphasizes that all presented information must be evidence-backed, reinforcing reliability for agents relying on its outputs.

Designed for use on local machines, agentmako does not offer a hosted service and requires Node.js version 20 or higher for installation. It is distributed under the Apache-2.0 license, allowing for open-source usage and modification. Installation is performed via npm, making it accessible for developers who want to integrate it into their local development environments.