gpp (git++)

KI-Agenten verändern Code kontinuierlich, verlieren dann aber die Arbeit, die zwischen Commits passiert – und die Notizen, die sie über deine Codebasis führen (CLAUDE.md, Memory-Banks, Knowledge-Dateien) veralten stillschweigend, wenn der Code weiterzieht. gpp ist ein Versionskontrollsystem, das für genau diese Realität gebaut wurde: Es erfasst jede Änderung in dem Moment, in dem sie passiert, befördert kuratierte Changesets mit Absicht und Herkunft und hostet das Projektwissen auf der eigenen Historie des Repos – wenn ein Commit also etwas ungültig macht, woran du über den Code geglaubt hast, kann gpp genau diesen Commit benennen.

(Die Aufzeichnung wird von scripts/demo.sh generiert – deterministisch, reproduzierbar, keine Mockups.)

30-Sekunden-Test

cargo install gpp-cli

gpp init --graphex
echo "fn main() {}" > main.rs
gpp timeline                     # captured already — no staging, no commit
gpp promote -m "first cut" --intent feature
gpp diff HEAD                    # semantic diff: renames/moves are one op

Und der Teil, den kein anderes VCS kann: festhalten, was du über den Code glaubst, und die Historie darüber wachen lassen:

gpp belief add --claim "token expiry is 24h" --evidence src/auth.rs:7-7
# ...weeks of commits later...
gpp belief bisect "token expiry is 24h"
# INVALIDATED  cs:fhcpef7c  "raise token expiry to 7 days"
#  -     7 | pub const EXPIRY_HOURS: u64 = 24;
#  +     7 | pub const EXPIRY_HOURS: u64 = 168;

Deterministisch – Diff-Schnittmengen und Blob-Hashes, keinerlei LLM- oder Netzwerk-Aufrufe. (Zur Einordnung: Bittet man das beste Frontier-Modell darum, zu beurteilen, ob eine gespeicherte Erinnerung invalidiert wurde, erreicht es auf dem STALE-Benchmark eine Genauigkeit von 55,2 % – hier ist es eine Abfrage an die Historie, keine Beurteilung.) Validität auf realer Historie in fünf Repos und vier Sprachen – axum 0.6→0.7, flask 1.1→2.0, clap 3→4, zod 3→4, go-redis 8→9 –, wo jede ungültig gewordene Annahme per Bisect auf einen eindeutig fixierten, dokumentierten Urheber-Commit zurückführt und die Kontrollannahmen überleben: siehe demos/belief-bisect/ für die vollständige Matrix.

Related MCP server: yksanjo/gmem

Was es anders macht

• Kontinuierliche Erfassung. Eine hochfrequente Timeline hält jede Dateiänderung fest (SQLite WAL, entprellter Beobachter); kuratierte Changesets werden daraus befördert – mit expliziter Absicht, Autoren-Art (Mensch/Agent) und Kostenprotokoll. Zwischen den Commits geht nichts verloren.

• Graphex: versioniertes, verschlüsseltes Projektwissen. Architektur, Konventionen, Entscheidungen und Annahmen liegen in einem verschlüsselten Wissensgraphen innerhalb des Repos, nach Vertrauensebene der Agenten gestaffelt, bei jedem Zugriff geprüft – und werden gegen die Historie, auf der das Wissen angesiedelt ist, auf Veraltheit geprüft.

• Agent-Governance. Agentenidentität erster Klasse mit Reputations-Scoring, Compliance-als-Code (Compliance-as-Code), Richtlinien, die beim Erfassen/Befördern/Synchronisieren angewendet werden, Anomalie-Erkennung und Token-/Kosten-Zuordnung pro Changeset.

Und alles andere – P2P-Sync über Noise, Replay, Review/RACK, ein Relay-Node, ein TUI – ist die Plattform darunter: siehe docs/ARCHITECTURE.md.

Git ist das Substrat, nicht die Konkurrenz. Die Brücke (gpp git-import / git-export / git-bridge) runden echte Git-Commits durch, so dass GitHub und bestehende Workflows erhalten bleiben – die Wissens-, Herkunfts- und Governance-Ebenen von gpp reiten mit. Die axum-Demo oben läuft vollständig auf über diese Brücke importierter History.

Claude Code (oder einen beliebigen MCP-Client) anbinden

GPP liefert einen MCP-Server mit; Agenten fragen den Verbundes-graphen ab (jede Annahme mit Frischheitshülle – Ankerpunkt, Zucker Inhibitor), schreiben ihre eigenen evidenz-verankerten Annahmen mit propose_belief (von Menschen freigegeben und anschließend von der History überwacht), schlagen Changesets vor und melden Kosten zusammen. Diese Datei in .mcp.json im Wurzelverzeichnis des Repos sein:

{
  "mcpServers": {
    "gpp": { "command": "gpp", "args": ["mcp-server", "--stdio"] }
  }
}

Vollständige Client-Einrichtung (Claude Desktop, generischer stdio) und die Liste der exponierten Werkzeuge: docs/MCP.md.

Status

Alle 9 Roadmap-Phase (0–8) umgesetzt. Siehe docs/ROADMAP.md für die Arbeit per Phase und dokumentative Abweichungen, docs/TODO.md für das priorisierte Backlog und docs/WORKLOG.md für das laufende Engineering-Protokoll.

Verifiziert am 2026-08-23: 184 Workspace-Tests bestehen, cargo clippy und cargo fmt sind sauber, der komplette Workspace baut. Es gibt keine Stub-Crate mehr – jede Crate hat eine funktionierende Implementierung. Der Abdeckungsgrad wird in CI gemessen (cargo llvm-cov; Basis 65,7 % Zeilenabdeckung, wird weiter erhöht).

Die Testtiefe ist noch ungleichmäßig: Grundschichten sind gut abgedeckt (gpp-core, gpp-graphex, gpp-diff, gpp-tui ≥ 80 % Zeilen), das CLI hat End-to-End-Suiten für Policy-Erzwingung, Kostenberichte, Reviewer-Zuweisung und Belief-Bisect, während mehrere Integrations-Crates weiterhin Stufe "Smoke" sind (gpp-sdk, gpp-notify, gpp-rbac, gpp-replay). „Implementiert" heißt hier gegen den Meilenstein gebaut und getestet, nicht unerschütthärt überall gehärtet. Diese Lücke zu schließen ist der wichtigste Punkt in docs/TODO.md.

Die vollständige Ebenen-Tabelle

Unter extensions/ auch: extensions/{gh-gpp,vscode-gpp,neovim-gpp}, GitHub Action-/GitLab CI-Vorlagen, Docker-Images in deploy/, Homebrew in packaging/.

Dokumentierte Folgeentwicklungen (aufgezeichnet im Roadmap/TODO und nicht übergangen): Registry-/Lizenz-API für Dependencies, native PyO3-PyO3/napi- Bindungen, Outbound-Platform-Review-Abgleich, Begin-homebrew/deb/dpkg-Pakete.

Installieren / Build

cargo install gpp-cli                    # the `gpp` binary (crates.io)
cargo install gpp-relay                  # relay node (optional)

# or from a clone
cargo build --release
cargo test --workspace
cargo bench -p gpp-core -p gpp-diff      # criterion perf suite

Vorgefertigte Binaries für Linux, macOS (ARM + Intel) und Windows sind bei jedem Release angehängt; cargo install --git https://github.com/mahabubul470/gpp gpp-cli verfolgt den Entwicklerstand des Stable-Release nicht veröffentlicht.

Mehr Probieren

# Governance
gpp policy template secrets-scan
gpp trust show
gpp audit --include-cost --include-graphex

# Decentralized: sync two repos over Noise
gpp sync serve 127.0.0.1:9473             # on peer A
gpp sync add a 127.0.0.1:9473 && gpp sync # on peer B

# GitHub-compatible
gpp remote setup --platform github --repository acme/webapp
gpp remote pr-create --base main

Siehe CLAUDE.md für den Projektkontext, docs/ für die vollständige Spezifikation (Architektur, Datenmodell, CLI, Protokolle, Roadmap) und docs/book/ für das Benutzerhandbuch und Tutorials.

Lizenz

MIT