Introduction

VeloGit is an agent-native, multi-tenant Git hosting platform built for high velocity. It moves beyond the legacy model of “Git as a System of Record” to become a System of Action, where AI intelligence acts as an ephemeral overlay rather than a noisy contributor.

The Vision: Agent-as-an-Overlay

VeloGit operates on the principle that the Git log should remain a pure record of human intent. Instead of AI bots creating spammy branches and PRs, VeloGit uses a Stateless Overlay model:

1. The Human Push: You push code to a branch.
2. The Shadow Analysis: AI Agents pull the code, analyze the diff, and generate high-fidelity suggestions (Shadow Fragments).
3. The Ghost UX: These suggestions are stored as metadata linked to the commit SHA and “ghosted” over your code in the UI.
4. The Meld: Humans can review these suggestions in the Ghost Workspace and click “Meld” to seamlessly apply the verified fix as a human-approved system commit.

Core Components

• Data Plane (Go): The central hub for API and Git RPC.
• Rituals Engine (Go): Orchestrates container-native pipeline runs and OCI image generation on managed or self-hosted runners.
• Agent Service (Go): A standalone, stateless service that listens to events and analyzes code.
• Ghost UI (Vue/Quasar): The desktop-class web interface for repository browsing and suggestion review.