How it works

Three components, each purpose-built.

The CLI never touches storage directly, and the server never touches git directly. Each layer has exactly one job.

HTTPS · push / pull internal HTTP · git ops CLI · syns Rust · any terminal Server + Web TypeScript · all logic auth · access · metadata · UI Git Engine Rust · git storage PostgreSQL metadata bare git repos local SSD
Rust

CLI (syns)

The primary interface. Push/pull files from any terminal. Like gh for GitHub — a fast client that always talks to the hosted server.

TypeScript

Server + Web

The cloud brain: all business logic, auth, access control, and metadata — plus the web UI for browsing and exploring. Stateless.

Rust

Git Engine

Owns all git storage on fast local disk. The server delegates git operations to it over HTTP; it has no public access of its own.