@yoyo-bot/cli

The command-line tool for YoYo — the universal binder registry for AI agents.

Search, install, fork, and publish binders from your terminal.

Install

npm install -g @yoyo-bot/cli

Quick Start

# Authenticate
yoyo auth

# Search for binders
yoyo search "knowledge base"

# Install a binder
yoyo bind personal-knowledge-wiki

# List your installed binders
yoyo list

# Create a new binder
yoyo init my-binder

# Publish your binder
yoyo publish

Commands

yoyo auth

Authenticate with your YoYo API key. Get one at yoyo.bot/settings.

yoyo auth
# Prompts for your API key and saves to ~/.yoyo/config.json

yoyo auth --key yoyo_your_key_here
# Set key directly

yoyo search <query>

Search the binder registry.

yoyo search "debugging"
yoyo search "rag" --category research
yoyo search --featured

yoyo bind <slug>

Install a binder. Downloads the full recipe — instructions, code, config, and examples.

yoyo bind personal-knowledge-wiki
yoyo bind knowledge-base-rag --org my-team

yoyo unbind <slug>

Remove an installed binder.

yoyo unbind personal-knowledge-wiki

yoyo list

List your installed and published binders.

yoyo list
yoyo list --org my-team

yoyo init <name>

Scaffold a new binder with the standard directory structure.

yoyo init my-binder
# Creates:
#   my-binder/
#   ├── binder.md
#   ├── manifest.json
#   ├── skills/
#   ├── src/
#   ├── config/.env.example
#   └── examples/

yoyo publish

Publish a binder to the YoYo registry.

cd my-binder
yoyo publish

yoyo whoami

Check your authentication status.

yoyo whoami
# → Authenticated as: david (yoyo_38LG...pzf)

What's a Binder?

A binder is a complete recipe for an AI agent — not just a prompt or a skill file, but the full package:

| Component | Purpose | |-----------|---------| | binder.md | The operating manual — architecture, workflows, conventions | | src/ | Runnable source code and scripts | | skills/ | Heuristic instruction files | | config/ | Parameters, env templates, schemas | | infrastructure/ | Dockerfiles, DAGs, Terraform, DB migrations | | examples/ | Worked demonstrations with expected output |

The agent is the chef. The binder is the recipe.

Configuration

Config is stored in ~/.yoyo/config.json:

{
  "apiKey": "yoyo_your_key_here",
  "apiUrl": "https://api.yoyo.bot/v1"
}

Also Available

• MCP Server: npx @yoyo-bot/mcp — native agent integration (14 tools)
• Copy Prompt: paste a one-liner into any agent to install a binder
• Web: yoyo.bot/binders — browse and fork

API Documentation

Full OpenAPI 3.0 spec for programmatic access:

curl https://api.yoyo.bot/v1/openapi.json

Quick start guide: curl https://api.yoyo.bot/v1/docs

Links

• Website: yoyo.bot
• Binders: yoyo.bot/binders
• MCP Server: @yoyo-bot/mcp
• GitHub: github.com/CG-Labs/YoYo

License

MIT