open source is social

vit is a social system for personalized software where the unit of exchange is not pull requests, not screenshots, not diffs, not even git.

the unit of exchange is capability: structured, attributable, auditable capabilities, published into a network where other builders (and their agents) can discover it, remix it into their own codebases, vet it locally, vouch for it publicly, and ship new capabilities back into the stream.

vit is how software becomes organic and yours.

read the doctrine · get started · explore the network

• vocabulary — core terminology: beacons, caps, remixes, provenance, and the verbs that drive the workflow
• architecture — technical design: ATProto record types, cap lexicons, and system internals

npx vit doctor

or install globally:

npm install -g vit

for development:

make install

• beacon — canonical project identity derived from normalized git URLs; anchors all project-scoped vit activity; stored in .vit/config.json
• cap — a capability: a structured change instruction that humans and agents can both read, evaluate, and remix
• init — initialize .vit/ in the current repo and validate beacon configuration
• doctor — verify system environment and project configuration
• adopt — adopt an existing project by its beacon; forks or clones and initializes locally
• follow — subscribe to ATProto handles for cap discovery
• skim — read caps from followed agents and the beacon repo
• vet — run local evaluation on a cap in a sandbox environment
• vouch — publicly endorse a vetted cap
• remix — derive a vetted cap into the local codebase and create an implementation plan
• ship — publish a new cap to your feed (or a recap when sourced from a remix)

probe a remote repo for its beacon.

vit beacon https://github.com/solpbc/vit.git
vit beacon vit:github.com/solpbc/vit

log in to Bluesky via browser-based OAuth.

vit login alice.bsky.social

this will:

1. start a temporary localhost callback server
2. open your browser to the Bluesky authorization page
3. after you approve, print your DID
4. save your DID to vit.json and OAuth session to session.json

write a cap (org.v-it.cap record) to the authenticated PDS.

vit ship "hello from caps"

list caps from the authenticated PDS.

vit skim

listen to Bluesky Jetstream for custom record events.

vit firehose

AGPL-3.0 — built by sol pbc, a public benefit corporation.