Skip to content

solpbc/vit

Repository files navigation

vit

open source is social

vit enabled open source is social


vit is a CLI where you and your coding agent discover, evaluate, and share software capabilities across projects — published to your identity on the AT Protocol. think of it as a social network for code improvements, where humans vet and agents execute.

get started · read the doctrine · explore the network

quick start

you run this (terminal):

npm install -g vit
vit setup
vit login your-handle.bsky.social

then open your coding agent (Claude Code, Codex CLI, or Gemini CLI) — it already knows how to use vit because setup installed the skill. your agent runs vit init to connect your project to the network, then vit skim to discover what others have built.

full getting started guide →

the verbs

four core verbs drive the loop:

  • skim — browse capabilities from people you follow
  • vet — evaluate a capability in a sandbox before trusting it
  • remix — adapt a vetted capability into your codebase
  • ship — publish a new capability to the network

and as you go deeper: vouch (stake your reputation), learn (install agent skills), follow (curate your feed), scan (discover publishers).

see COMMANDS.md for the full command reference and VOCAB.md for the complete vocabulary.

install

npm install -g vit

or try it out without installing:

npx vit doctor

for contributors working on vit itself:

make install

works with

vit is a human+agent collaboration tool. it works with Claude Code, Codex CLI, and Gemini CLI. some commands are for you (setup, login, vet), others are for your agent (skim, remix, ship).

reference

  • COMMANDS.md — full command reference
  • VOCAB.md — terminology: capabilities, beacons, skills, and the verbs that drive the workflow
  • ARCHITECTURE.md — technical design: ATProto record types, cap lexicons, and system internals

contributing

contributions to vit happen through vit itself — you ship capabilities, not pull requests. this isn't a policy; it's the product working as designed. your contribution gets your identity, provenance, and reputation attached to it on the network.

read CONTRIBUTING.md for the full setup and the skim/vet/remix/ship loop.

links

  • homepage — what vit is and why it exists
  • getting started — prerequisites, setup, and first run
  • doctrine — the philosophy behind social open source
  • explore — browse live capabilities, skills, and projects on the network
  • lexicons — published AT Protocol schemas (cap, skill, vouch)
  • contributing — how to contribute to vit itself

license

MIT — built by sol pbc, a public benefit corporation.

About

open source is social

Resources

License

Contributing

Stars

Watchers

Forks

Contributors