Voiscribd
Voiscribd Docs

CLI

vsbd CLI

Use Spark from Terminal with predictable prompt resolution and provider/model overrides.

vsbd is Voiscribd's Terminal command for Spark text processing.

Install

Voiscribd attempts automatic user-local install during onboarding when possible.

Manual privileged install path:

  • /usr/local/bin/vsbd

You can verify with:

vsbd --version
vsbd --help

If vsbd is not found, restart terminal after installation.

Core Commands

vsbd spark [INPUT|-] [--instruction TEXT] [--provider NAME] [--model NAME] [--prompt QUERY]
vsbd prompts ls [--json]
vsbd providers ls [--json]
vsbd models ls [--json]
vsbd ls prompts|providers|models [--json]

spark Input Behavior

INPUT can be:

  • existing file path
  • - (stdin)
  • inline literal text

If both piped stdin and positional input are provided, vsbd returns a usage error.

spark Options

  • -q, --instruction TEXT
  • -r, --provider NAME
  • -m, --model NAME
  • -p, --prompt QUERY
  • --dry-run
  • --wrap (default)
  • --no-wrap

Prompt Resolution Order

When using --prompt, resolution order is:

  1. UUID
  2. exact title (case-insensitive)
  3. exact slug
  4. unique partial match

Recommended CLI Patterns

Pipe text from another command

cat notes.txt | vsbd spark -p "Email Polisher"

Force a specific provider/model

echo "Fix this text" | vsbd spark -p rewrite -r xAI -m grok-4.3

Preview without execution side effects

vsbd spark --dry-run -p rewrite

Useful Examples

echo "Fix this text" | vsbd spark -p rewrite -r xAI -m grok-4.3
cat notes.txt | vsbd spark -p "Email Polisher" -q "make it concise"
vsbd spark --dry-run -p rewrite
vsbd prompts ls
vsbd providers ls --json
vsbd models ls

Airplane Mode and Provider Rules

In Airplane Mode, Spark calls that require external endpoints are blocked.

Local-network endpoints can still work (depending on provider configuration).

Trial/Licensing

vsbd spark follows app entitlement rules.

If trial/license constraints block Spark, the CLI returns a clear error.

Troubleshooting

"Provider not found" or "Model not found"

Run:

vsbd providers ls
vsbd models ls

Then re-run with exact provider/model names.

Prompt match is ambiguous

Use prompt UUID or exact title instead of partial name.