Onboard your agent

Onboard your AI agent to Tilebox by installing the Tilebox CLI and Agent Skills, then configuring your API key. After completing it, your agent will be able to manage your Tilebox resources and use Tilebox-specific skills to create and query datasets, submit and monitor jobs. It will also be able to write geospatial workflows, deploy it to clusters, submit jobs and iterate on the workflow code after inspecting job logs and checking outputs. If you want to use Tilebox directly as a developer, start with the developer quickstart.

Using a LLM Chat interface instead of an agent? If you want to integrate Tilebox into your LLM Chat interface, rather than your agent, check out our MCP server instead.

1. Install the Tilebox CLI and Agent Skills

   Install the Tilebox CLI and Tilebox Agent Skills with the setup wizard.

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

   Copy

   The CLI is the default interface for coding agents because it works in the same terminal where the agent edits files, runs tests, and applies changes. The skills add task-level instructions for CLI usage, dataset management, job monitoring, workflow authoring, and automations.

2. Authenticate the CLI

   Set TILEBOX_API_KEY in the environment where your agent runs. You can create an API key in the Tilebox Console.

   export TILEBOX_API_KEY="YOUR_TILEBOX_API_KEY"

   Copy

   Use a key with the smallest permissions needed for the task you want the agent to perform.

3. Verify the setup

   Ask your agent to inspect its Tilebox capabilities before assigning a larger task.

   You

   Check your Tilebox setup. Confirm whether the tilebox CLI is installed, whether you can inspect commands with tilebox agent-context, which Tilebox skills are available, and which datasets are available. Do not modify any Tilebox resources.

Next steps

Learn how to Iterate on Workflow Releases with Agents, or check out the CLI Reference to get an overview of useful tilebox terminal commands.