agentmako

agentmako ist eine Local-First-Codebase-Intelligence-Engine für KI-Coding-Tools.

Sie bietet Agenten wie Codex, Claude Code, Cursor und lokalen Harnesses ein typisiertes MCP-Toolset, um ein Projekt zu verstehen, bevor sie Änderungen vornehmen. Mako indiziert Ihr Repository, erstellt lokale SQLite-basierte Fakten, verfolgt Diagnosen und Review-Notizen und liefert strukturierte Kontextpakete zurück, anstatt den Agenten alles mühsam mit raw grep neu entdecken zu lassen.

Mako wurde für die erste Phase der Arbeit von Coding-Agenten entwickelt:

Welche Dateien sind wichtig? Welche Routen, Symbole, Tabellen, Diagnosen und früheren Erkenntnisse sind relevant? Was sollte der Agent als Nächstes lesen?

Was Sie erhalten

• MCP-Server für Coding-Agenten: agentmako mcp

• Lokales Dashboard: agentmako dashboard

• Deterministische Kontextpakete: context_packet, reef_scout

• Tools für Codesuche und -struktur: cross_search, live_text_search, ast_find_pattern, repo_map

• Reef Engine Fakten und Erkenntnisse über indizierte, Working-Tree- und Staged-Zustände hinweg

• Aufnahme von TypeScript-, ESLint-, Oxlint-, Biome- und Staged-Git-Diagnosen

• Optionale Postgres/Supabase-Schema-Snapshots und schreibgeschützte DB-Inspektion

• Lokale DB-Review-Kommentare für Notizen zu Tabellen, RLS, Triggern, Publikationen, Abonnements und Replikation

• Recall, Bestätigungen und Agenten-Feedback für wiederholte Review-Arbeiten

Alles Wichtige läuft lokal. Es ist kein gehosteter Dienst erforderlich.

Related MCP server: Context Zero Engine

Installation

Erfordert Node.js 20 oder neuer.

npm install -g agentmako

Bestätigen Sie, dass die CLI verfügbar ist:

agentmako doctor

Sie sollten grüne Häkchen für die Konfiguration und den lokalen API-Dienst sehen.

Möchten Sie lieber aus dem Quellcode bauen (z. B. um einen Beitrag zu leisten)? Siehe Develop From Source am Ende dieser Datei.

Happy Path Setup

1. Ihr echtes Projekt einbinden

Gehen Sie zu dem Projekt, das Mako verstehen soll:

cd C:/path/to/your/project

Einbinden und indizieren:

agentmako connect . --no-db

Verwenden Sie --no-db für den ersten Durchlauf. Dies bringt den Code-Intelligence-Pfad zum Laufen, bevor der Datenbank-Scope hinzugefügt wird.

2. Bestätigen, dass Mako das Projekt sieht

agentmako status .
agentmako tool list

Führen Sie eine echte Scout-Abfrage aus:

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

Wenn dies gerankte Kandidaten, Fakten oder Erkenntnisse zurückgibt, funktioniert das grundlegende Setup.

3. Ihren MCP-Client konfigurieren

Fügen Sie dies zu Ihrer MCP-Client-Konfiguration hinzu:

{
  "mcpServers": {
    "mako-ai": {
      "command": "agentmako",
      "args": ["mcp"]
    }
  }
}

Starten Sie den MCP-Client neu und bestätigen Sie, dass der mako-ai-Server startet.

Starten Sie im Agenten mit einem dieser Tools:

• tool_search, wenn Sie das richtige Mako-Tool finden müssen

• context_packet, wenn Sie eine Coding-Aufgabe haben und einen Startkontext wünschen

• reef_scout, wenn Sie gerankte Projektfakten/-erkenntnisse/-historie wünschen

• ask, wenn Sie eine natürlichsprachliche Repository-Frage haben

4. Optional: Claude Code Plugin verwenden

Standard-MCP funktioniert mit Claude Code, aber das gebündelte Plugin fügt Mako-spezifische Claude-Skills hinzu und enthält die gleiche agentmako mcp-Verkabelung in mako-ai-claude-plugin/.mcp.json.

Voraussetzungen:

• Claude Code installiert

• Node.js 20+ im PATH (das Plugin führt npx -y agentmako mcp aus, was automatisch das veröffentlichte agentmako-Paket abruft — keine separate globale Installation erforderlich)

• Ihr Zielprojekt ist bereits mit agentmako connect eingebunden

Vom Root des agentmako-Repositorys aus:

claude plugin validate .\mako-ai-claude-plugin
claude --plugin-dir .\mako-ai-claude-plugin

Führen Sie in Claude Code /mcp aus und bestätigen Sie, dass mako-ai verbunden ist.

Das Plugin stellt diese Skills bereit:

• /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

Verwenden Sie das Plugin, wenn Claude Code Mako-spezifische Anleitungen dazu laden soll, welche Tools aufgerufen werden sollen und wie deren Ergebnisse zu interpretieren sind.

5. Optional: Dashboard starten

Von Ihrem Zielprojekt aus:

agentmako dashboard .

Dies startet die lokale API, den Harness-Dienst und das Web-Dashboard.

6. Optional: Supabase/Postgres-Bewusstsein hinzufügen

Mako funktioniert ohne Datenbank. Fügen Sie dies erst hinzu, nachdem die Code-Intelligence funktioniert.

Für ein einmaliges interaktives Setup:

agentmako connect .

Für CI oder skriptgesteuertes Setup unter Verwendung einer Umgebungsvariablen:

set DATABASE_URL=postgres://...
agentmako connect . --db-env DATABASE_URL --yes

Aktualisieren und verifizieren Sie dann den lokalen Schema-Snapshot:

agentmako refresh .
agentmako verify .

Der interaktive Modus speichert Datenbank-Geheimnisse standardmäßig in Ihrem OS-Schlüsselbund. Die Projektkonfiguration speichert Referenzen, keine Klartext-DB-URLs.

Normaler täglicher Ablauf

Vom Zielprojekt aus:

agentmako status .
agentmako dashboard .
agentmako --json tool call . context_packet "{\"query\":\"fix the broken auth callback route\"}"

Für Staged-Review-Prüfungen:

agentmako git precommit . --json

Für Datenbank-Review-Notizen:

agentmako --json tool call . db_review_comment "{\"objectType\":\"replication\",\"objectName\":\"supabase_database_replication\",\"category\":\"review\",\"comment\":\"Check publication coverage before relying on realtime events.\",\"tags\":[\"supabase\",\"replication\"]}"

Aus Quellcode entwickeln

Wenn Sie selbst an Mako arbeiten möchten, klonen und bauen Sie es, anstatt es von npm zu installieren.

Voraussetzungen:

• Node.js 20 oder neuer

• Git

• Corepack (corepack enable, in modernem Node.js enthalten)

git clone https://github.com/drhalto/agentmako.git
cd agentmako
corepack pnpm install
corepack pnpm run build
npm link ./apps/cli

npm link ./apps/cli macht die aus dem Quellcode gebaute CLI als agentmako in Ihrem PATH verfügbar und ersetzt jede globale npm-Installation. Führen Sie nach dem Abrufen von Änderungen erneut corepack pnpm run build aus.

Um zur veröffentlichten Version zurückzukehren: npm install -g agentmako.

Entwicklungsprüfungen

corepack pnpm run typecheck
corepack pnpm run build
corepack pnpm run test:smoke:reef-tooling
corepack pnpm run test:smoke:reef-model-facing-views

Vollständige Verifizierung:

corepack pnpm test

Repository-Struktur

apps/
  cli/              agentmako CLI and MCP entrypoint (the published package)
  web/              local dashboard
packages/
  contracts/        public TypeScript contracts and tool schemas
  config/           shared config helpers
  logger/           shared logger
  sdk/              programmatic SDK
  store/            SQLite stores, migrations, and query helpers
  tools/            shared tool implementations
  harness-core/     local agent harness runtime
  harness-tools/    action tools available to the harness
  harness-contracts/ harness contracts and provider catalog
services/
  api/              local API and MCP transports
  engine/           Reef Engine fact/finding pipeline
  harness/          local harness HTTP service
  indexer/          repo and schema indexing logic
  worker/           background worker
extensions/         provider and integration packages
storage/            schema migrations, models, queries
test/smoke/         smoke coverage
mako-ai-claude-plugin/ Claude Code plugin with Mako skills

Weitere Dokumentation

• Tool-Übersicht

• CLI-Dokumentation

• Reef Engine

• Claude Code Plugin

• Agenten-Anleitung zum Einfügen in CLAUDE.md / AGENTS.md

• Mitwirken

• Sicherheitsrichtlinie

• Changelog

Lizenz

Apache-2.0. Siehe LICENSE.