gito/README.md

Gito

Gito is a platformless Git control plane for agent-driven development workflows.

It manages registered repositories, workspace leases, Git operations, agent-shell execution, provider adapters, and normalized events. Git itself stays platform-neutral; GitHub, GitLab, Gitea, Plane, Jira, and similar systems are integrated through adapters.

Direction

• Server: Go
• Control surface: Flutter app and gitoctl in future slices
• State: PostgreSQL as source of truth
• Event acceleration: Redis optional, not required for the first slice
• Internal transport: proto-socket first
• REST: health/readiness, smoke/curl, provider callbacks, simple admin bootstrap
• gRPC: intentionally excluded from the initial design

Runtime Shape

Flutter UI / gitoctl
        |
Control Plane
        |
Core Domain
        |
Worker / Scheduler
        |
Agent Shell / IOP / Git Engine
        |
Provider Adapters

Repository Layout

apps/client/          Flutter control surface scaffold
services/core/        Go control plane, worker, shell commands
packages/contracts/   proto-socket, REST, event, and provider contract notes
docs/                 Architecture and operation notes
bin/                  Root test/lint/build helpers
agent-ops/            Agent operating rules
agent-test/           Local validation rules

First Commands

bin/test
bin/lint
bin/build

The initial Go scaffold is intentionally small but buildable. Flutter platform directories are not generated yet; apps/client currently records the control surface boundary and a minimal Dart entry point.