Use the deftro command-line tool

deftro is the Deftro command-line tool. With Node.js installed, run it with npx @deftro/cli <command>, or install it once with npm i -g @deftro/cli and type deftro <command>. The package is on npm.

Sign in

Run deftro login. It prints a code and waits while you approve it on the device page. See Connect an agent. deftro whoami shows who you are signed in as, and deftro logout forgets the sign-in on this machine.

The main commands

• deftro find <query> and deftro suggest <task>: look for skills. Suggest never installs anything by itself.
• deftro install <handle>/<slug>@<version>: install one exact version. Leave out @<version> to take the newest one you can see.
• deftro init --org <org> --project <project>: tie this repository to a project.
• deftro sync: install everything your projects say this machine should have. Files you edited are skipped unless you add --force.
• deftro status: list installed skills that were edited or are missing locally.
• deftro publish [folder] --semver <version>: upload a skill folder as a new version. It is private unless you choose otherwise.
• deftro import [folder]: find every skill in a folder and upload them all (--dry-run lists them first).
• deftro shortcuts and deftro context: manage browser shortcuts and Baton context. See Browser extension and Context.

bv.lock and pinned versions

Every install is recorded in bv.lock at the root of your project: the skill, its exact version, a fingerprint of its files, and which agents it went to. Running deftro install without a version never silently upgrades a skill already in bv.lock; name the new version to move it. If bv.lock is not valid, deftro refuses to touch it until you fix or delete it.

Where skills are written

deftro looks at your project and writes to each agent it finds:

• Claude Code: .claude/skills/<slug>/
• Cursor: .cursor/rules/<slug>.mdc
• Antigravity and others that read .agents/skills: .agents/skills/<slug>/
• Codex and Gemini CLI: a list in AGENTS.md pointing at .agents/skills/

If none is found, it uses .agents/skills/. Pick one with --agent claude, cursor, antigravity or agents-md.