v̇it manifesto

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.

install

npx vit doctor

or install globally:

npm install -g vit

for development:

make install

terminology

• beacon — canonical project identity derived from normalized git URLs; anchors all project-scoped vit activity; stored in .vit/config.json
• 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)

beacon

probe a remote repo for its beacon.

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

| option | description | |---|---| | -v, --verbose | show step-by-step details |

login

log in to Bluesky via browser-based OAuth.

usage

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

options

• -v, --verbose - show discovery and protocol details
• --force - force re-login, skip session validation

firehose

listen to Bluesky Jetstream for custom record events.

usage

vit firehose

options

• --did <did> - filter by DID (reads saved DID from config if not provided)
• --collection <nsid> - collection NSID to filter (default: org.v-it.cap)
• -v, --verbose - show full JSON for each event

ship

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

vit ship "hello from caps"

| option | description | |---|---| | --did <did> | DID to use (default: from config) |

skim

list caps from the authenticated PDS.

vit skim

| option | description | |---|---| | --did <did> | DID to use (default: from config) | | --limit <n> | max records to return (default: 25) |