---
title: "Onboard your agent"
description: "Configure an AI agent with the Tilebox CLI and Tilebox skills."
---

> Documentation Index
> Fetch the complete documentation index at: https://tilebox.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboard your agent

import AgentPrompt from "@docs/components/AgentPrompt.astro";
import { Steps } from "@docs/components/ui/steps";

## Automatic setup

Paste this prompt into your coding agent:

Set up Tilebox using tilebox.com/SKILL.md

## Step-by-step setup

Install the Tilebox CLI and Agent Skills, configure your API key, and verify the setup with the steps below. If you want to use Tilebox directly as a developer, start with the [developer quickstart](/docs/quickstart).

:::tip
**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](/docs/ai/mcp) instead.
:::

1. ### Install the Tilebox CLI and Agent Skills

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

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

    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](https://console.tilebox.com/settings/api-keys).

```bash
export TILEBOX_API_KEY="YOUR_TILEBOX_API_KEY"
```

    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.

      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](/docs/guides/workflows/agentic-workflow-iteration), or check out the [CLI](/docs/cli) to get an overview of useful `tilebox` terminal commands.

Source: https://tilebox.com/docs/ai/onboard-your-agent/index.mdx