drhalto/agentmako

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