Taskbox
CLI

@taskbox/cli

tbx is the JSON-out command-line surface over @taskbox/tools. It speaks Podman by default, prints TaskResult JSON on stdout, and uses the PRD §16.5 exit-code map (e.g. 2 schema, 3 runtime, 4 image, 5 timeout, 7 network, 9 artifact, 10 tool exit). Pass --jsonl to stream events as they happen.

  • Stability: beta
  • Platforms: node (Linux/macOS with Podman)

Install

npm i -g @taskbox/cli
# or
npx @taskbox/cli doctor

Subcommands

CommandWhat it does
tbx doctorVerifies Podman is reachable, prints rootless flag and version.
tbx preparePulls the kitchen-sink image (pullPolicy: if-missing) and prints its digest.
tbx media subtitles <url>Downloads subtitles for <url>. Honours --languages, --format, --auto, --proxy, --output-dir, --timeout.

Quick example

tbx doctor
tbx prepare
tbx media subtitles https://youtu.be/jNQXAC9IVRw \
  --languages en,de --format srt --output-dir /tmp/subs --timeout 60s

See Getting Started for the full flag walkthrough or API for exit codes and the JSON / JSONL output shapes.

On this page