CLI commands

Scope

This reference is a searchable inventory of the public command graph in the current stable Superbee CLI. Use superbee <command> --help for every option, default, safety precondition, and example attached to one command.

The inventory is generated from executable help and checked for drift. It is verified against the current stable release.

Invocation and selection

superbee <command> [options]
superbee <command> --help

For local operations, --dir <path> selects a bundle explicitly. --remote <url> selects the HTTP backend explicitly and is mutually exclusive with --dir. Without either, local selection follows the resolution order documented in Configuration and bundle resolution.

Generated command inventory

The text between the markers is owned by npm run cli-reference:build. Do not edit it by hand.

Generated from the current stable package's executable help. 34 command entries are present.

Output modes

Ordinary successful receipts use compact TOON by default. Add --json when the command supports it and a machine needs JSON. Parse the selected structured form; avoid scraping descriptive help text.

Two commands deliberately reserve stdout for bytes:

• doc read --out -, --body-out -, or --rendered-out - writes the requested bytes to stdout;

• pull --out - writes canonical document or raw blob bytes to stdout.

In those modes receipts and errors move to stderr. mcp also reserves stdout for JSON-RPC and sends diagnostics to stderr. See CLI errors and exit codes for failures.

Command-family map

Stability and evidence

The command graph comes from tagged command-spec.ts and the packed executable help. Descriptions and defaults can change between pre-1.0 releases. Always pair automated usage with the release evidence and the exact command's help.