An AI-native version control system built in Rust. gpp replaces Git's commit-centric model with a continuous-capture architecture designed for a world where AI agents are first-class code contributors.
See CLAUDE.md for project context, docs/ for the
full specification (architecture, data model, CLI, protocols, roadmap), and
docs/book/ for the user guide + tutorials.
All 9 phases (0–8) implemented. See docs/ROADMAP.md
for the per-phase deliverables and documented deviations, and
docs/TODO.md for the prioritized backlog of what's next.
Verified 2026-05-18: 123 workspace tests pass, cargo clippy and
cargo fmt clean, full workspace builds. No stub crates remain — every
crate has a working implementation.
The test suite is currently all in-crate unit tests (no tests/
integration dirs yet) and its depth is uneven: foundational layers are
well covered (gpp-core 23, gpp-graphex 17, gpp-diff 13, CLI 16),
while several integration/UI crates have only smoke-level coverage
(gpp-sdk 1; gpp-notify/gpp-rbac/gpp-replay/gpp-tui 2 each).
"Implemented" here means built and smoke-tested against its milestone,
not exhaustively tested or hardened everywhere. Closing that gap is the
top item in docs/TODO.md.
| Layer | Crate | What's implemented |
|---|---|---|
| Storage | gpp-core |
Content-addressed store (BLAKE3 + zstd), Blob/Tree, raw verified frame transfer |
| Timeline | gpp-timeline |
SQLite (WAL) capture, .gppignore, debounced watcher, pruning |
| History | gpp-history |
Changeset/Intent/Author, branch refs, promote, DAG walk |
| Diff | gpp-diff |
Line + tree-sitter semantic diff (Rust/Python/TS/Go), rename/move detection |
| Git bridge | gpp-git-bridge |
git-import/git-export/git-bridge, SQLite hash map |
| Graphex | gpp-graphex |
Encrypted (age + AES-GCM) knowledge graph, tier-gated projection, query, lifecycle, audit |
| SDK / MCP | gpp-sdk |
AgentSession; gpp mcp-server --stdio (JSON-RPC MCP) |
| Trust | gpp-trust |
Reputation scoring, status transitions, overrides, events |
| Policy | gpp-policy |
.policy TOML rules, promotion-time enforcement, built-in templates |
| Cost | gpp-cost |
Per-changeset token/$ records, budgets, efficiency |
| Anomaly | gpp-anomaly |
Scope/burst/size detection, resolution workflow |
| Sync | gpp-sync |
Noise_XX P2P; objects/refs/policies/graphex; fork-preserve |
| Replay | gpp-replay |
Reproducible environment snapshots + drift diff |
| Review/RBAC/Notify | gpp-review gpp-rbac gpp-notify |
Review lifecycle, roles + branch protection, events/inbox/HMAC webhooks |
| Remote | gpp-remote |
GitHub/GitLab/Bitbucket PR creation, enriched bodies, plain-Git push |
| Relay | gpp-relay |
Always-on sync hub binary + health endpoint + Dockerfile |
| Clients | gpp-cli gpp-tui gpp-deps |
Full CLI, ratatui TUI (gpp ui), dependency intel (gpp deps) |
Also: extensions/{gh-gpp,vscode-gpp,neovim-gpp}, GitHub Actions +
GitLab CI templates, deploy/ Docker images, packaging/ Homebrew.
Documented follow-ups (recorded in the ROADMAP, not silently skipped): live registry/CVE/license APIs, native PyO3/napi bindings, bidirectional platform-review polling, apt/dpkg packages, passphrase-wrapped master key.
cargo install --git https://github.com/gpp-vcs/gpp gpp-cli # the `gpp` binary
cargo install --git https://github.com/gpp-vcs/gpp gpp-relay # relay nodecargo build --release
cargo test --workspace
cargo bench -p gpp-core -p gpp-diff # criterion perf suite# Solo-dev flow
gpp init --graphex .
echo "fn main() {}" > main.rs
gpp timeline # continuous capture
gpp promote -m "first cut" --intent feature
gpp log --oneline
gpp diff HEAD # semantic diff
# AI-native: connect an agent over MCP
gpp mcp-server --stdio
# 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