Documentation

Start with the five-minute quickstart. If you know git, the Rosetta stone will make sgit feel familiar in one read.

Introduction

What is sgitThe pitch, the mechanism, the architecture Installationpip install, verify, upgrade QuickstartCreate, commit, push, clone — in 5 minutes

Concepts

sgit for git usersThe Rosetta stone: same verbs, three differences The two-branch modelClone branches, named branches, and why The security modelWhat the server sees; the crypto stack Keys and signaturesEncrypting to someone who holds no vault key

Messaging & the API

Sending messages between vaultsAppend lanes + PKI, composed into a worked example The HTTP APIEndpoints, headers, gates, limits and error codes Append lanesThe write-only transport behind vault messaging

Guides

Working with AI agentswrite, --json, sparse clones, multi-agent patterns Use casesFive workflows, all on shipped commands SG/Vault platformThe browser app, vault apps, the window.sg bridge

Project

When NOT to use sgitThe honest page Why does this exist?Answering the no-market criticism, plus a FAQ If a vault key is exposedThe rotation runbook, with a real case study Cross-team briefsOpen asks to the CLI and API teams Admin & engineeringHow this site is built and released GitHubSource, issues, changelog

Coming next: a full per-command CLI reference, generated directly from the CLI's own argument parser on every release — so the reference can never drift from the shipped tool.