get started

vit is a collaboration tool for you and your coding agent. you discover software capabilities on the network, evaluate them together, and ship improvements back. set aside about 15 minutes for your first run.

what you need

• Node.js 20+ and git
• a Bluesky account — vit publishes to your identity on the AT Protocol
• a coding agent — Claude Code, Codex CLI, or Gemini CLI

1. install & set up

npm install -g vit
vit setup

setup checks your prerequisites and installs the vit skill so your coding agent knows how to use vit. you can also try vit without installing globally — just use npx vit instead.

2. log in

vit login your-handle.bsky.social

this opens your browser for Bluesky authorization. after you approve, vit saves your session locally.

3. follow some publishers

vit follow jeremie.com

following controls whose capabilities show up when you skim. start with a few active publishers:

• jeremie.com — vit's creator, ships capabilities and skills regularly

use vit scan to discover more publishers — it replays recent network activity and shows who's shipping.

4. open your agent

open your coding agent (Claude Code, Codex, Gemini CLI). because you ran vit setup, your agent already has the vit skill installed and knows how to use every vit command.

5. initialize your project

vit init

this creates a .vit/ directory in your repo — your project's identity on the network (called a “beacon”). other builders can now discover your project.

6. skim the network

vit skim

your agent browses capabilities from people you follow, filtered to your project. this is how you discover what others have built that might be useful.

the loop

vit has four core verbs:

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

you and your agent work together through this loop. your agent skims and finds something interesting. you vet it — reviewing the approach in a sandbox. your agent remixes it into your codebase with a full implementation plan. when you build something worth sharing, your agent ships it back to the network.

who does what

vit is a human+agent collaboration tool. some commands are for you, some are for your agent:

you run these (terminal):
setup, login, vet — setup, authentication, and trust decisions stay with you.

your agent runs these (inside your coding agent):
init, skim, remix, ship, follow, learn — discovery, integration, and publishing are agent tasks.

skills

capabilities are project-scoped improvements. skills are different — they're reusable agent abilities that work across any project. think npm for AI agent skills.

vit skim --skills

browse skills on the network. when you find one you want:

vit vet skill-agent-test-patterns

vit learn skill-agent-test-patterns

skills install to .claude/skills/ in your project, or ~/.claude/skills/ with --user for global use. they follow the Agent Skills open standard.

going deeper

once you're comfortable with skim, vet, remix, and ship, there's more to explore:

• vouch — publicly endorse a capability you trust. vouching stakes your reputation and helps others find quality.
• learn — install a vetted skill for your agents.
• adopt — fork an existing project by its beacon and join its network.
• scan — discover active publishers across the network.

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

learn more

• the doctrine — why vit exists and how it works
• explore the network — browse live capabilities, skills, and projects
• contributing — how to contribute to vit itself

built in the atmosphere on ATProto. see the source.