Git History Viewer

Ein kostenloser, lokal-first, schreibgeschützter Git-Verlaufsgraph für Browser, CLI und MCP-Clients.

Öffentliche Alpha. Legen Sie in verwalteten Umgebungen eine exakte Version fest.

Installation

Erfordert Node.js 22 oder höher und Git 2.40 oder höher.

npm install --global @peekaboo-develop/git-history-viewer@alpha

Related MCP server: git-insights-mcp

Repository öffnen

cd /path/to/repository
git-history-viewer web .

Der Viewer öffnet eine reine Loopback-Browsersitzung für diese Arbeitskopie. Er führt kein Klonen, Fetch, Pull oder Push durch und verändert den Git-Zustand nicht. Remote-Tracking-Refs zeigen den letzten Zustand, der von Ihrem bestehenden Git-Workflow abgerufen wurde.

Für die MCP-Einrichtung beginnen Sie mit einem reinen Metadaten-Zugriff:

git-history-viewer mcp --repo /absolute/path/to/repository --content-policy metadata

Entwicklung

npm install
npm test
npm run license:check
npm run test:pack
node bin/git-history-viewer.mjs web . --port 0 --no-open
node bin/git-history-viewer.mjs web . --port 0 --no-open --ollama-model qwen3:4b
node bin/git-history-viewer.mjs config path
node bin/git-history-viewer.mjs config validate
node bin/git-history-viewer.mjs profiles list
node bin/git-history-viewer.mjs web . --ai-profile local-fast --ai-profile local-deep
node bin/git-history-viewer.mjs mcp --repo /absolute/path --content-policy metadata
node bin/git-history-viewer.mjs cache status

Die Standard-MCP-Richtlinie legt keine Patches, Autoren-E-Mails oder absoluten Pfade offen. Die Anwendung ruft niemals Git-Zustand ab und verändert ihn niemals.

Der Web-Header enthält einen AI接続-Leitfaden für verifizierte Codex-, Claude-Code- und Cursor-MCP-Einrichtungsvorlagen. Er bearbeitet niemals eine Client-Konfiguration und legt den absoluten Pfad des Repositorys nicht offen. Ein ausgewählter Commit kann einen kurzen MCP-Prompt erzeugen, der nur seine OID enthält.

Der optionale Web-KI-Ablauf ist deaktiviert, sofern nicht eine Option --ai-profile oder die veraltete Option --ollama-model angegeben wird. Profile unterstützen Ollama über numerisches Loopback sowie die offiziellen OpenAI-, Anthropic- und Google-APIs. Jeder Anbieter zeigt eine Vorschau der exakten Metadaten-Nutzlast und erfordert vor der Generierung einen zweiten Klick. Wenn mehrere Profile aktiviert sind, stellt der Detailbereich einen Modellwähler bereit. Remote-Endpunkte und Anmeldedaten-Namen sind im Code festgelegt: OpenAI liest OPENAI_API_KEY, Anthropic liest ANTHROPIC_API_KEY und Google liest GEMINI_API_KEY. Schlüssel werden niemals vom Browser oder aus der Konfigurationsdatei akzeptiert. Loopback allein beweist nicht, wo Ollama ein Modell ausführt. Patches, Dateiinhalte, Identitäten, absolute Pfade, Refs, Remotes und Commit-IDs werden nicht gesendet.

Der Konfigurationspfad ist betriebssystemspezifisch und wird von config path ausgegeben. Das strikte JSON-Format speichert keine Anmeldedaten, beliebigen Endpunkte, Prompts oder Namen von Umgebungsvariablen:

{
  "schemaVersion": "1",
  "defaultProfileId": "local-fast",
  "profiles": [
    {
      "id": "local-fast",
      "label": "Local fast",
      "provider": "ollama",
      "model": "qwen3:4b",
      "ollamaPort": 11434,
      "maxOutputTokens": 1536
    },
    {
      "id": "openai-fast",
      "label": "OpenAI fast",
      "provider": "openai",
      "model": "gpt-5.4-mini",
      "maxOutputTokens": 1536
    },
    {
      "id": "claude-balanced",
      "label": "Claude balanced",
      "provider": "anthropic",
      "model": "claude-sonnet-4-6",
      "maxOutputTokens": 1536
    },
    {
      "id": "gemini-fast",
      "label": "Gemini fast",
      "provider": "google",
      "model": "gemini-2.5-flash",
      "maxOutputTokens": 1536
    }
  ]
}

Konfigurationsänderungen erfordern einen Neustart. --ai-profile ist wiederholbar und stellt die explizite Allowlist für diese Web-Sitzung dar. Exportieren Sie den entsprechenden festen Schlüssel nur, wenn Sie ein Remote-Profil auswählen.

Der KI-Ergebnis-Cache verwendet begrenzte, shardierte JSON-Dateien im Benutzer-Cache-Verzeichnis des Betriebssystems. Cache-Metadaten speichern keine API-Schlüssel, rohen Prompts, Diffs, Repository-Pfade oder Remote-URLs; generierte Ergebnisse können dennoch sensiblen Quelltext wiederholen. --no-ai-cache umgeht Lese- und Schreibvorgänge. cache clear entfernt nur erkannte Cache-Eintragsdateien.

Der Commit-Detailbereich kann bis zu zwei versionsneutrale Links aus einer zusammengestellten Registrierung offizieller Dokumentationen für starke Pfadmarkierungen wie GitHub-Actions-Workflows, Docker-/Compose-Dateien, TSConfig, Vite-Konfiguration und Vue-SFCs empfehlen. Die Linkanzeige führt keinen Netzwerkzugriff durch. Eine separate Schaltfläche kann begrenzte Auszüge direkt von diesen festen offiziellen URLs über einen DNS-Rebinding-resistenten HTTPS-Transport mit gepinnter IP abrufen. Das Ziel kann die erkannte Technologie ableiten, aber Repository-Namen, Pfade, Commits, Nachrichten, Cookies, Anmeldedaten und Referrer werden nicht gesendet. Weiterleitungen werden abgelehnt. Wenn KI aktiviert ist, können eine weitere separate Vorschau und Bestätigung die angezeigten Auszüge sowie opake Zitier-IDs an den ausgewählten Anbieter senden; offizielle URLs und Titel werden niemals an das Modell gesendet und werden nur vom Server zurückgemappt. Die Versionserkennung bleibt nicht verfügbar.

Siehe docs/PRODUCT_SPEC.md, docs/ARCHITECTURE.md, docs/MCP.md, docs/SECURITY.md und docs/ROADMAP.md für das normative Design und die geplante Unterstützung von Remote-Umgebungen.

Release-Vorbereitung und Rollback sind in docs/RELEASING.md dokumentiert. Das Erstellen eines Artefakts berechtigt nicht zur Veröffentlichung.