⚡ Dual Execution: Standalone and Git Plugin
GitProof is designed to fit naturally into your terminal muscle memory. Because Git automatically resolves any binary named git-<subcommand> in your $PATH as a native Git subcommand, you can run GitProof in two interchangeable ways:
TERMINALInterchangeable Execution Modes
# 1. Direct binary execution gproof status # 2. Native Git subcommand execution git proof status
📖 Complete Command Reference
| Command | Description | Primary Flags |
|---|---|---|
status |
Inspects working tree state, commit HEAD, Merkle tree hash, author identity, and license tier. | — |
seal |
Computes the Merkle DAG, serializes repository state into .gitproof/proof.json, and anchors timestamps. |
--notarize, --tsa-url |
verify |
Cryptographically validates repository integrity and TSA certificate chain against proof.json. |
--proof <file> |
cert |
Generates a court-admissible Federal Rule of Evidence 902 vector PDF certificate of authenticity. | -o <output.pdf> |
badge |
Renders a dynamic SVG badge for README markdown showing verified authorship status and commit hash. | -o <badge.svg> |
hook |
Installs, inspects, or removes automated pre-push and pre-commit Git lifecycle hooks. |
install, status, remove |
auth |
Activates an offline Ed25519 Pro or Team license token without contacting remote billing servers. | <license-token> |
upgrade |
Checks for newer releases, validates SHA-256 integrity, and performs in-place binary self-upgrade. | --check, --force |
version |
Displays binary version, build commit, target architecture, and compilation timestamp. | — |
💻 Practical Examples
1. Initializing and Sealing a Project
TERMINALGenerate Local Proof
gproof seal
✅ Repository cryptographically sealed: .gitproof/proof.json
🌲 Merkle Root: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
📄 Commit HEAD: c32c9b82552ca3c3ce4a9b9cede9a84a502494ef
✍️ Author: Justin Grant <jgrant27@gmail.com>
2. Qualified DigiCert Notarization
TERMINALTimestamp Against Public TSA
gproof seal --notarize ⏱️ Contacting DigiCert Time Stamp Authority (RFC 3161)... ✅ Qualified atomic timestamp received and embedded in proof.json 🛡️ Verified at: 2026-10-15T13:18:45Z (TSA: DigiCert Inc)
3. Generating Court Exhibit PDF
TERMINALGenerate Evidence Document
gproof cert -o FRE902-Certificate.pdf ✅ Generated judicial evidence certificate: FRE902-Certificate.pdf ⚖️ Grounded in FRE 902(11), 902(13), and 902(14).
🔧 Environment Variables
GITPROOF_KEY: Ed25519 license key string for Pro/Team activation (useful for CI/CD and automated developer provisioning).GITPROOF_TSA_URL: Custom RFC 3161 Time Stamp Authority endpoint URL (defaults to DigiCerthttp://timestamp.digicert.com).GITPROOF_CONFIG: Override path for custom GitProof configuration files.