CLI

The sbs command

An auto-generated command-line interface that gives you convenient access to every API operation from your terminal — built as a wrapper around restish, which generates commands directly from the OpenAPI spec.

Because the CLI is generated from the API schema, it comes with:

Install

The CLI ships with the Python SDK:

pip install skillberry-store-sdk

It requires restish to be installed. If it's missing, the CLI prints installation instructions:

# Option 1: with Go
go install github.com/rest-sh/restish@latest

# Option 2: download a pre-built binary from
# https://github.com/rest-sh/restish/releases

Connect

By default the CLI connects to http://0.0.0.0:8000 and remembers your connection for future commands:

sbs --help                       # Show all available commands
sbs connect http://prod:8000     # Point at a different server
sbs list-skills                  # List all skills

Command groups

GroupCommands
Toolscreate-tool, list-tools, get-tool, get-tool-module, update-tool, delete-tool, execute-tool, search-tools, add-tool
Skillscreate-skill, list-skills, get-skill, update-skill, delete-skill, search-skills, detect-anthropic-skills, import-anthropic-skill, export-anthropic-skill
Snippetscreate-snippet, list-snippets, get-snippet, update-snippet, delete-snippet, search-snippets
VMCP Serverscreate-vmcp-server, list-vmcp-servers, get-vmcp-server, update-vmcp-server, delete-vmcp-server, start-vmcp-server, search-vmcp-servers
vNFS Serverscreate-vnfs-server, list-vnfs-servers, get-vnfs-server, update-vnfs-server, delete-vnfs-server, start-vnfs-server, search-vnfs-servers
Adminmetrics, purge-all, health, health-ready

A complete workflow

# 1. Connect to your server
sbs connect http://localhost:8000

# 2. Add a new tool
sbs create-tool --name calculator --description "Basic calculator"

# 3. Execute it with parameters
sbs execute-tool calculator --body='{"params":{"x":5,"y":3}}'

# 4. Group tools into a skill
sbs create-skill --name math-skill --description "Math utilities"

# 5. Expose the skill as a virtual MCP server
sbs create-vmcp-server --name my-server --skill-uuid <uuid>

# 6. Search semantically
sbs search-tools --search-term "calculator functions"

Output formats & filtering

sbs list-tools                 # JSON (default)
sbs list-tools -o yaml         # YAML
sbs list-tools -o table        # Table

sbs list-tools --filter='state=active'
sbs list-tools --offset=20 --limit=10
sbs list-tools -v              # Verbose request/response

Scripting

The CLI slots naturally into shell scripts and pipelines:

# Back up all tools
sbs list-tools -o json > tools-backup.json

# Capture a tool's result as JSON
RESULT=$(sbs execute-tool my-tool --body='{"params":{}}' -o json)

The complete command reference, advanced flags, and troubleshooting live in the repository's CLI documentation.