For developers

Script your library with jbox.

The Jesters' Box CLI comes with the desktop app. Use it in build scripts, or let any AI assistant with terminal access search your library for you.

Search, tag, and export from the terminal.

Use jbox in your own build scripts to set up a project before you even open your engine. Enable Automation & CLI in the running app, then check the connection and search your workspace. Add an export step when you want selected files copied into the project.

CLI HELPjbox --help
Jesters' Box CLI — bundled desktop automation (protocol 1)
Enable access in Settings → Automation & CLI. The app must be running.

status
  Show the app connection and automation status.
doctor
  Check connection, protocol compatibility, and workspace access.
capabilities
  Describe commands and accessible workspace capabilities.
workspaces list
  List accessible workspaces.
workspaces inspect --workspace <id>
  Inspect a workspace and its limits.
assets list --workspace <id>
  List or search assets with pagination.
  Options: --query, --type, --collection, --tags, --untagged, --offset, --limit, --sort, --direction
assets search --workspace <id>
  Search asset names, types, and tags.
  Options: --query, --type, --collection, --tags, --untagged, --offset, --limit, --sort, --direction
assets inspect <asset> --workspace <id>
  Read asset metadata.
assets preview <asset> --workspace <id>
  Export a thumbnail to a new file.
  Options: --out
tags list --workspace <id>
  Read the tag taxonomy.
tags create --workspace <id>
  Create a tag.
  Options: --name, --color, --parent
tags add --workspace <id>
  Add existing tags by ID or exact name; preserve other tags.
  Options: --assets, --tags
tags remove --workspace <id>
  Remove selected tags; preserve other tags.
  Options: --assets, --tags
tags apply --workspace <id>
  Apply a JSON batch of {assetId, add: [], remove: []} changes.
  Options: --input
collections list --workspace <id>
  List collections.
collections create --workspace <id>
  Create a collection.
  Options: --name, --parent, --description
collections move-assets --workspace <id>
  Move assets into a collection; use home for the workspace root.
  Options: --assets, --collection
import <paths> --workspace <id>
  Import files or folders. Preview with --dry-run.
  Options: --collection, --dry-run
export <asset> --workspace <id>
  Export an asset into a directory. Existing files are never overwritten.
  Options: --out, --version, --include-dependencies, --dry-run
transfer preview --workspace <id>
  Preview a cross-workspace copy and destination quota.
  Options: --to, --assets, --collection, --include-history
transfer copy --workspace <id>
  Copy selected assets to another workspace.
  Options: --to, --assets, --collection, --include-history
versions list <asset> --workspace <id>
  List asset versions.
versions add <asset> --workspace <id>
  Create a new asset version from a file.
  Options: --file, --label
trash list --workspace <id>
  List recoverable deleted items.
trash add --workspace <id>
  Move assets to recoverable trash.
  Options: --assets
trash restore <item> --workspace <id>
  Restore a trash item.
jobs list
  List recent automation jobs.
jobs inspect <job>
  Inspect a job, progress, and paginated per-item results.
  Options: --offset, --limit
jobs wait <job>
  Wait for a job to finish.
jobs cancel <job>
  Cancel a queued job or a supported running import.

Global: --json --fields id,name --wait --timeout <seconds> --request-id <id>
        --connection <connection.json> --help
Jobs persist across CLI exits. App shutdown interrupts unfinished jobs.
Use the same --request-id to retrieve a previous job instead of repeating a mutation.
List values accept multiple arguments or commas; quote paths and tag names with spaces.
STARTUP EXAMPLEstart-project.sh
#!/bin/sh
set -eu
: "${WORKSPACE_ID:?Set WORKSPACE_ID}"
: "${PROJECT_DIR:?Set PROJECT_DIR}"
: "${ASSET_QUERY:?Set ASSET_QUERY}"

jbox doctor
mkdir -p "$PROJECT_DIR"
jbox assets search --workspace "$WORKSPACE_ID" \
  --query "$ASSET_QUERY" --limit 5 --json \
  > "$PROJECT_DIR/jestersbox-assets.json"
exec "$@"

Set WORKSPACE_ID, PROJECT_DIR, and ASSET_QUERY, then pass your normal game or dev command to the script.

Every asset. One box.

Free on your machine, no account needed. Be first to know when it launches.

Get notified at launch
Windows first · Coming soonmacOS · Coming afterLinux · Coming after
  • Windows 10 or 11 (64-bit)
  • Internet only for cloud features