skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
tilebox/skills86 installs

tilebox-cli

Use the Tilebox CLI for datasets, workflows, docs search, automations, parallel task runners. Use when a task involves tilebox commands. How to handle authentication, JSON output, agent-context schemas, pagination, installation, or upgrades.

How do I install this agent skill?

npx skills add https://github.com/tilebox/skills --skill tilebox-cli
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The skill provides instructions for the Tilebox CLI, including installation and upgrade commands from the vendor's domain. It involves executing shell commands and parsing external data, which creates a surface for potential indirect prompt injection.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Using Tilebox CLI

Use this skill whenever interacting with the tilebox command-line tool. Prefer machine-readable output and command schema discovery so automation remains robust.

Core Rules For Agents

  • Always ensure the CLI is up to date before relying on workflow behavior: check tilebox --version, follow Updating The CLI below, then refresh command schemas. Do not treat these skills as evidence that an older binary supports a new flag.
  • Always pass --json in agent workflows when the command supports it; never pass --interactive.
  • Always submit workflow-project jobs with --workflow . or an exact remote reference, including local managed-runner tests. Only use unscoped jobs for an explicitly requested direct Python runner or a Python script executed as a direct runner for testing; see tilebox-workflow-jobs.
  • Use tilebox agent-context <command path> --output-schema before relying on a command's output shape.
  • Pass authentication via TILEBOX_API_KEY unless the user explicitly asks to use --api-key.
  • Use --api-url only when targeting a non-default API environment.
  • For paginated commands, read next_cursor from JSON output and pass it back as --cursor until it is empty.
  • Use tilebox agent-context <command> when behavior is unclear.

Authentication And API URL

The CLI authenticates with either:

export TILEBOX_API_KEY=...
tilebox account get --json

or per command:

tilebox account get --api-key "$TILEBOX_API_KEY" --json

The default API is https://api.tilebox.com. Override it for staging or local environments:

# a staging env
tilebox --api-url https://api.tilebox.dev account get --json

If auth is missing, commands return a validation-style usage error. After installation, or when investigating authentication failures, use tilebox account get --json to verify the API endpoint and active credential. Do not print or log API keys.

JSON Output

Always use --json for supported commands in agent workflows:

tilebox dataset list --json
tilebox job list --last 7d --json
tilebox job get <job-id> --json

--json emits compact, unstyled, non-paginated output even under a pseudo-terminal. Human output may contain terminal styling, and --interactive may start a pager, so agents should not use either.

Combine JSON Output With jq

Use jq for quick field extraction, filtering, and shell pipelines. Keep tilebox responsible for structured output and jq responsible for selecting the fields you need. Prefer keeping intermediate and final output as JSON objects or arrays.

Examples:

# List dataset slugs
tilebox dataset list --json | jq '[.[].slug]'

# Extract a submitted job ID
JOB_ID=$(tilebox job submit --workflow . --name <job-name> --task <task-name> --input '{}' --json | jq -r '.id')

# Initialize locally; a fresh project has no remote workflow reference yet
PROJECT_SLUG=$(tilebox workflow init --name "Scene QA" --json | jq -er '.project_slug')

# After first publication or explicit linking, resolve the remote reference
WORKFLOW_REFERENCE=$(tilebox workflow get --json | jq -er '.reference')

# Inspect failed jobs from a query response
tilebox job list --last 7d --state failed --json | jq '{jobs: [.jobs[] | {id, state, name}]}'

# Page through commands manually by reading next_cursor
tilebox job logs <job-id> --limit 100 --json | jq -r '.next_cursor'

# Read storage location IDs and typed provider references
tilebox storage-location list --json | jq '{storage_locations: [.storage_locations[] | {id, name, reference}]}'

Use jq -e when a script should fail if a required value is missing:

tilebox job get <job-id> --json | jq -e '.state == "completed"'

Discovering Commands And Output Schemas

Use agent-context to inspect available commands, arguments, flags, descriptions, and output schemas. It always returns JSON; do not add --json to agent-context commands.

Describe the whole CLI:

tilebox agent-context

Describe one command:

tilebox agent-context job list --output-schema

Typical workflow:

  1. Run tilebox agent-context <command path> --output-schema.
  2. Read required args/flags and the JSON output schema.
  3. Run the command with --json.
  4. Parse fields according to the schema.

Searching Tilebox Docs

Use tilebox docs search to browse and retrieve relevant excerpts from docs.tilebox.com without leaving the CLI. It is useful when you need current product documentation, conceptual guidance, examples, or SDK/API details before choosing command flags or implementation details.

tilebox docs search "dataset schema custom fields"
tilebox docs search "query datasets temporal extent spatial extent"
tilebox docs search "workflow job retry logs spans"

Search with natural-language phrases that include the product area and the exact concept, command, SDK type, or error you care about. Prefer a focused query over a broad one:

# Good: scoped to a feature and expected terminology
tilebox docs search "dataset query spatial extent GeoJSON Polygon"

# Too broad: likely to return mixed concepts
tilebox docs search "query"

Use docs search when:

  • agent-context tells you the CLI shape, but you need conceptual docs or examples.
  • You need SDK or API behavior that may not be obvious from CLI help.
  • You want to confirm current docs terminology before writing user-facing documentation.

Do not use docs search for command output schemas; use tilebox agent-context <command path> --output-schema for that.

Pagination

Some commands return paginated results with a next_cursor field. Pass this as --cursor to fetch the next page of results. Loop until next_cursor is empty. For example:

tilebox job list --last 7d --limit 100 --json
tilebox job list --last 7d --limit 100 --cursor <next_cursor> --json

Keep the same filters and sort order across pages. Only change --cursor.

Installing The CLI

The setup wizard installs the Tilebox CLI and Agent Skills, and offers to install uv if it is missing:

curl -fsSL https://install.tilebox.com/wizard.sh | sh

The CLI installer downloads a released binary, verifies checksums, and installs to $HOME/.local/bin by default. To install only the CLI with a custom install directory:

curl -fsSL https://install.tilebox.com/cli.sh | TILEBOX_INSTALL_DIR="$HOME/bin" sh

Install a specific version only when intentionally pinned; set VERSION to the selected available release:

curl -fsSL https://install.tilebox.com/cli.sh | TILEBOX_VERSION="$VERSION" sh

Ensure the install directory is on PATH, set TILEBOX_API_KEY, then verify the installation and authentication:

tilebox account get --json

Updating The CLI

Check tilebox --version at the start of a task. Keep released binaries current with the built-in upgrade command, then check the version again and refresh agent-context:

tilebox --version
tilebox upgrade --json
tilebox --version

For scoped tasks, local project linking, and template initialization, target CLI >=0.14 and Tilebox Python packages >=0.68. These are the planned release baseline, not a claim that those versions are already published. Check the latest available release and installed command schemas. If the required release/feature is unavailable, report the blocker; do not silently fall back to remote-creating init, guessed links, or unscoped submission. Use a prerelease or development build only when the user has selected that channel.

Respect deliberately pinned installations and managed environments: explain the required upgrade before changing their policy. Upgrade runner machines too; upgrading the submitter alone does not update running managed runners. Within workflow projects, regularly check and update the Tilebox Python dependencies and lockfile using tilebox-workflow-authoring's dependency guidance, not just the CLI.

Install an intentionally selected release (VERSION must satisfy the project's requirements):

tilebox upgrade --version "$VERSION" --json

Force reinstall:

tilebox upgrade --force --json

Notes:

  • tilebox upgrade requires sh and curl.
  • It is not supported for dev builds or Windows.
  • If the binary was installed in a custom directory, set TILEBOX_INSTALL_DIR when needed.

Useful Command Families

The current CLI exposes these top-level command families. Run tilebox agent-context after CLI changes to refresh the list.

FamilyPurposeUseful Commands
accountInspect the active account, usage overages, and subscription tier.tilebox account get, tilebox account subscription, tilebox account usage, tilebox whoami
automationInspect and manage persistent automations.tilebox automation list, tilebox automation get <automation-id>, tilebox automation create, tilebox automation update <automation-id>, tilebox automation delete <automation-id>
storage-locationInspect storage locations used by automation triggers.tilebox storage-location list, tilebox storage-location get <storage-location-id>
clusterManage workflow compute clusters.tilebox cluster list, tilebox cluster get <cluster-slug>, tilebox cluster create <name>, tilebox cluster delete <cluster-slug>
datasetCreate, update, inspect, query, find datapoints, and generate types for datasets.tilebox dataset list, tilebox dataset get <dataset-slug>, tilebox dataset create, tilebox dataset update <dataset-slug>, tilebox dataset query <dataset-slug>, tilebox dataset find <dataset-slug> <datapoint-id>, tilebox dataset generate --slug <dataset-slug>
dataset collectionManage collections within a dataset.tilebox dataset collection list --dataset <dataset-slug>, tilebox dataset collection get <name> --dataset <dataset-slug>, tilebox dataset collection create <name> --dataset <dataset-slug>, tilebox dataset collection delete <name> --dataset <dataset-slug>
jobSubmit, monitor, debug, retry, wait for, and cancel workflow jobs.tilebox job submit, tilebox job list, tilebox job get <job-id>, tilebox job wait <job-id>, tilebox job retry <job-id>, tilebox job cancel <job-id>, tilebox job logs <job-id>, tilebox job spans <job-id>
workflowInitialize local projects, copy templates, link remote destinations, and release workflows.tilebox workflow init, tilebox workflow init --template <reference>, tilebox workflow link <reference>, tilebox workflow create, tilebox workflow list, tilebox workflow get, tilebox workflow build-release, tilebox workflow publish-release, tilebox workflow deploy-release, tilebox workflow undeploy-release
docsSearch Tilebox documentation from the CLI.tilebox docs search "<query>"
parallelRun a shell command multiple times in parallel.tilebox parallel -n <count> -- <command> [args...]
upgradeUpgrade or reinstall the Tilebox CLI.tilebox upgrade, tilebox upgrade --version <version>, tilebox upgrade --force
agent-contextDescribe command metadata and output schemas for agents.tilebox agent-context, tilebox agent-context job list --output-schema

Safety And Verification

  • For destructive actions, such as cluster delete, confirm intent unless the user explicitly asked for the action.
  • When a command fails, read the error text first. Validation errors usually name the exact flag or argument to fix. Otherwise refer to the agent-context for the command.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/tilebox/skills/tilebox-cli">View tilebox-cli on skillZs</a>