agentmako

agentmako is a local-first codebase intelligence engine for AI coding tools.

It gives agents like Codex, Claude Code, Cursor, and local harnesses a compact Reef-first tool surface for understanding a project before they edit it. Mako indexes your repo, builds local SQLite-backed facts, tracks diagnostics and review notes, and answers evidence-backed questions instead of making the agent orchestrate broad tool chains or rediscover everything with raw grep.

Mako is built for the first mile of coding-agent work:

What files matter? What routes, symbols, tables, diagnostics, and prior findings are relevant? What should the agent read next?

What You Get

• MCP server for coding agents: agentmako mcp
• Local dashboard: agentmako dashboard
• Primary project query: reef_ask across code, database, findings, diagnostics, instructions, freshness, and literal checks
• Queryable workflow orientation: mako_help
• Deterministic context expansion: context_packet
• _hints on tool results so agents get result-specific next steps
• Central MCP annotations so clients can distinguish safe reads, live reads, and local-state mutations
• Compact loop/fallback tools: reef_status, reef_verify, reef_impact, live_text_search, lint_files, and tool_batch
• Reef Engine facts and findings across indexed, working-tree, and staged state
• Reef convention extraction for auth guards, runtime boundaries, generated paths, route patterns, and schema usage
• TypeScript, ESLint, Oxlint, Biome, and staged git diagnostic ingestion
• Hot-reloaded .mako/rules YAML rule packs, including primitive cross-file helper-bypass rules via canonicalHelper
• Optional Postgres/Supabase schema snapshots and read-only DB inspection
• Local DB review comments for notes on tables, RLS, triggers, publications, subscriptions, and replication
• Recall, acknowledgements, and agent feedback for repeated review work

Everything important runs locally. No hosted service is required.

Install

Requires Node.js 20 or newer.

npm install -g agentmako

Confirm the CLI is available:

agentmako --version
agentmako doctor

You should see green checks for configuration and the local API service.

Prefer to build from source (e.g. to contribute)? See Develop From Source at the bottom of this file.

Happy Path Setup

1. Attach your real project

Go to the project you want Mako to understand:

cd C:/path/to/your/project

Attach and index it:

agentmako connect . --no-db

Use --no-db for the first run. It gets the code intelligence path working before adding database scope.

2. Confirm Mako sees the project

agentmako status .
agentmako tool list

Run a real Reef query:

agentmako --json tool call . reef_ask "{\"question\":\"where should I inspect auth route state?\"}"

If that returns an evidence-backed answer, facts, findings, or next queries, the core setup is working.

reef_ask plans over code, database, durable findings, diagnostics, and exact literal evidence. App-flow questions favor file, route, and finding evidence; RLS/schema questions favor database facts and review comments. To inspect p

... View full README on GitHub