Weft documentation

Everything here is real git. Mirror stops your CI waiting on clones. Repos gives you a repository per user or per agent session over REST. Review and Workflows land and check changes on either. Public repositories are free forever.

Start here

Three steps, in order. The first two take a minute each.

1. Create an account. Free, no card. Your namespace holds public repositories; a team gets an organization. Sign up
2. Make an organization and a token. An organization is where a team or a private repository lives; a public mirror or repository can live in your own namespace. A token is what your CI and scripts sign in with. Authentication
3. Pick a quickstart. Point CI at a mirror in five minutes, or make your first commit over REST. Both end with a clone. Mirror in 5 minutes · First commit over REST

Understand the system

• How serving works: why empty-disk nodes are fast
• Changes, OWNERS and landing: per-commit review and the fast-forward land queue
• The freshness contract: never a silent stale miss
• Organizations and billing: what a seat is, and what a failed payment does not do

Operate

• Webhooks — inbound origin events, outbound push events
• Workflows — CI from a .weft/*.yml file, on our runners or yours
• Running a self-hosted runner — the operator’s side: the binary, a systemd unit, and how to isolate it
• CI integration — bring your own CI: sign a verdict onto the Checks tab
• Export & escape hatch — bundles, org-wide
• Metrics & usage — p50/p99, CSV, Prometheus
• Service limits — the honest v1 envelope

For agents

Machine-consumable surfaces, kept current with the docs build:

• /llms.txt — index of this documentation
• /llms-full.txt — the full documentation as one file
• /openapi.json — the REST API, OpenAPI 3.1