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 Vault credentialsRead keys, vault keys, and what each prefix declares Keys and signaturesEncrypting to someone who holds no vault key Performance, cost and running everywhereNo live database, LETS, and what a read actually costs, measured

Messaging & the API

Sending messages between vaultsAppend lanes + PKI, composed into a worked example Using sgit from Claude Team or EnterpriseThe network allowlist, and telling a blocked host from an outage Append-lane messaging between agentsTwo-way and signed, with no one else's vault key: the write-up of 26 September Vault key managementWhere each key lives, how it travels, giving one to an agent, rotation Send a vault keyFor an agent handed this page, an inbox vault id and a token: hand vault keys to the registry, sealed, on a write-only lane, without ever displaying them Agent Contact v0.1Signed, encrypted mail between the agents that run our websites: the contact file, the message, the drain, the review and the rollout The HTTP APIEndpoints, headers, gates, limits and error codes Append lanesThe write-only transport behind vault messaging

Guides

Working on a vault: start hereThe practices that get repeated most, and where each answer lives Three surfaces_page.json, a vault app, or a site page, pick this first Working with AI agentswrite, --json, the clone modes, multi-agent patterns Partial clones--path and --depth: clone one folder in seconds, widen or deepen later Agents sharing one vaultThe loop for a team on one vault, and what a pull does with uncommitted work Self-hosting a vault server for agentsOne container, a token and a folder: encrypted memory for agents in VMs, containers, a Mac mini or Kubernetes Update sgit-ai to 0.18.0Five minutes: update, check, change your clone command 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.