From fdb05ed0d9e9d7afcc6e0d808f37adfe835ae5a5 Mon Sep 17 00:00:00 2001 From: Lukas Bindreiter Date: Thu, 25 Jun 2026 15:56:01 +0200 Subject: [PATCH] Document installation wizard --- agent-onboarding.mdx | 29 +++++++------------ agents-and-ai-tools/agent-skills.mdx | 11 +++++-- agents-and-ai-tools/tilebox-cli.mdx | 12 ++++++-- .../workflows/agentic-workflow-iteration.mdx | 3 +- guides/workflows/deploy-to-your-compute.mdx | 2 +- index.mdx | 2 +- onboard-your-agent.mdx | 19 ++++-------- sdks/go/install.mdx | 2 +- 8 files changed, 38 insertions(+), 42 deletions(-) diff --git a/agent-onboarding.mdx b/agent-onboarding.mdx index 4449e83..c14e5ee 100644 --- a/agent-onboarding.mdx +++ b/agent-onboarding.mdx @@ -8,18 +8,17 @@ If you are using ChatGPT or claude.ai, stop. Tell the user to switch to Codex or Get the agent ready to use Tilebox from the terminal: -1. Install the Tilebox CLI. -2. Install the Tilebox skills. -3. Help the user create an API key. -4. Give the user the exact shell command to set `TILEBOX_API_KEY` and reload their current environment. -5. Verify read-only setup. Do not change Tilebox resources. +1. Install the Tilebox CLI and Agent Skills. +2. Help the user create an API key. +3. Give the user the exact shell command to set `TILEBOX_API_KEY` and reload their current environment. +4. Verify read-only setup. Do not change Tilebox resources. -## Step 1: install the Tilebox CLI +## Step 1: install the Tilebox CLI and Agent Skills Run: ```bash -curl -fsSL https://cli.tilebox.com/install.sh | sh +curl -fsSL https://install.tilebox.com/wizard.sh | sh ``` Then verify: @@ -35,17 +34,9 @@ If `tilebox` is not on `PATH`, use the default installed path directly: $HOME/.local/bin/tilebox --help ``` -## Step 2: install Tilebox skills +Confirm the Tilebox skills are present in the user's skills directory. -Run: - -```bash -npx skills add tilebox/skills --yes --global -``` - -Then confirm the Tilebox skills are present in the user's skills directory. - -## Step 3: ask the user for an API key +## Step 2: ask the user for an API key Send the user here: @@ -57,7 +48,7 @@ Ask them to create a key with the smallest permissions needed for their task. Do not ask them to paste the key into chat unless there is no safer option. Prefer that they run a command in their own terminal. -## Step 4: give the exact command for their shell +## Step 3: give the exact command for their shell Detect the user's shell with: @@ -97,7 +88,7 @@ Fish universal variables apply to new shells automatically. For the current shel set -gx TILEBOX_API_KEY "YOUR_TILEBOX_API_KEY" ``` -## Step 5: verify safely +## Step 4: verify safely Run read-only checks only: diff --git a/agents-and-ai-tools/agent-skills.mdx b/agents-and-ai-tools/agent-skills.mdx index 81f7023..5524436 100644 --- a/agents-and-ai-tools/agent-skills.mdx +++ b/agents-and-ai-tools/agent-skills.mdx @@ -8,9 +8,16 @@ import { AgentPrompt } from '/snippets/components.mdx'; Tilebox skills are task-level instructions for AI agents. They explain how to use the Tilebox CLI, which command patterns to prefer, and how to approach common workflows such as dataset management and job monitoring. -## Install Tilebox skills +## Install Tilebox skills and the CLI -Install the skills from the Tilebox skills repository. +Many skill operations require the [Tilebox CLI](/agents-and-ai-tools/tilebox-cli), +which is why it's recommended to use our installation wizard that sets up both Skills and the CLI on your system. + +```bash +curl -fsSL https://install.tilebox.com/wizard.sh | sh +``` + +If you want to customize the skill installation directory, or select just a subset of the skills to install, you can use ```bash npx skills add tilebox/skills diff --git a/agents-and-ai-tools/tilebox-cli.mdx b/agents-and-ai-tools/tilebox-cli.mdx index 839d1e5..9a775db 100644 --- a/agents-and-ai-tools/tilebox-cli.mdx +++ b/agents-and-ai-tools/tilebox-cli.mdx @@ -13,9 +13,17 @@ The CLI is also the default Tilebox interface for coding agents that can run ter Install the Tilebox CLI with the install script. ```bash -curl -fsSL https://cli.tilebox.com/install.sh | sh +curl -fsSL https://install.tilebox.com/cli.sh | sh ``` + +If you want to install the Tilebox CLI and Agent Skills together, use the setup wizard instead. + +```bash +curl -fsSL https://install.tilebox.com/wizard.sh | sh +``` + + ## Authenticate The CLI reads the `TILEBOX_API_KEY` environment variable. Create an API key in the [Tilebox Console](https://console.tilebox.com/settings/api-keys), then export it in the shell or agent environment that runs CLI commands. @@ -76,7 +84,7 @@ This pattern is safer for agents because generated JSON, geometry, and descripti The Tilebox skills include guidance for using the CLI in agent workflows. Install them when you want an agent to combine CLI commands into higher-level tasks such as managing datasets, monitoring jobs, or configuring automations. ```bash -npx skills add tilebox/skills +curl -fsSL https://install.tilebox.com/skills.sh | sh ``` After installing the skills, ask your agent to inspect `tilebox agent-context` and follow the relevant Tilebox skill before running commands that change resources. If your agent cannot use a terminal, configure the [Tilebox MCP server](/agents-and-ai-tools/tilebox-mcp) instead. diff --git a/guides/workflows/agentic-workflow-iteration.mdx b/guides/workflows/agentic-workflow-iteration.mdx index e025a09..c9f7850 100644 --- a/guides/workflows/agentic-workflow-iteration.mdx +++ b/guides/workflows/agentic-workflow-iteration.mdx @@ -15,9 +15,8 @@ Use this loop when you want the code under test to match the artifact that relea Set up the Tilebox command-line tool and skills in the environment where your agent runs. ```bash -curl -fsSL https://cli.tilebox.com/install.sh | sh +curl -fsSL https://install.tilebox.com/wizard.sh | sh export TILEBOX_API_KEY="YOUR_TILEBOX_API_KEY" -npx skills add tilebox/skills ``` Ask the agent to inspect the command-line tool before changing resources. diff --git a/guides/workflows/deploy-to-your-compute.mdx b/guides/workflows/deploy-to-your-compute.mdx index 0c61ecf..2b7149d 100644 --- a/guides/workflows/deploy-to-your-compute.mdx +++ b/guides/workflows/deploy-to-your-compute.mdx @@ -64,7 +64,7 @@ RUN apt-get update && apt-get install -y --no-install-recommends ca-certificates && rm -rf /var/lib/apt/lists/* \ && apt-get clean -RUN curl -fsSL https://cli.tilebox.com/install.sh | TILEBOX_INSTALL_DIR=/usr/local/bin TILEBOX_NO_INSTALL_COMPLETIONS=1 sh +RUN curl -fsSL https://install.tilebox.com/cli.sh | TILEBOX_INSTALL_DIR=/usr/local/bin TILEBOX_NO_INSTALL_COMPLETIONS=1 sh # Required at runtime: set TILEBOX_CLUSTER to a valid cluster slug and # TILEBOX_API_KEY to an API key that can read deployments and claim tasks. diff --git a/index.mdx b/index.mdx index 2085fea..c7a1592 100644 --- a/index.mdx +++ b/index.mdx @@ -123,7 +123,7 @@ export const HomeSearch = () => {
```bash CLI wrap -curl -fsSL https://cli.tilebox.com/install.sh | sh +curl -fsSL https://install.tilebox.com/cli.sh | sh tilebox dataset query open_data.copernicus.sentinel2_msi diff --git a/onboard-your-agent.mdx b/onboard-your-agent.mdx index 708f25b..7193c13 100644 --- a/onboard-your-agent.mdx +++ b/onboard-your-agent.mdx @@ -14,7 +14,7 @@ on this page, and follow the agent-onboarding guide instead, which was designed this purpose.
-Onboard your AI agent to Tilebox, by installing the Tilebox CLI, installing Tilebox Agent skills and 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. +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](/quickstart). @@ -24,14 +24,14 @@ If you want to integrate Tilebox into your LLM Chat interface, rather than your - - Install the Tilebox CLI with the install script. + + Install the Tilebox CLI and Tilebox Agent Skills with the setup wizard. ```bash - curl -fsSL https://cli.tilebox.com/install.sh | sh + 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 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. 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). @@ -42,15 +42,6 @@ If you want to integrate Tilebox into your LLM Chat interface, rather than your Use a key with the smallest permissions needed for the task you want the agent to perform. - - Install the Tilebox skills so your agent has task-level instructions for working with the CLI and Tilebox resources. - - ```bash - npx skills add tilebox/skills - ``` - - The skills cover CLI usage, dataset management, job monitoring, workflow authoring, and automations. - Ask your agent to inspect its Tilebox capabilities before assigning a larger task. diff --git a/sdks/go/install.mdx b/sdks/go/install.mdx index 8df1576..fe02eb7 100644 --- a/sdks/go/install.mdx +++ b/sdks/go/install.mdx @@ -28,5 +28,5 @@ go get github.com/tilebox/tilebox-go Install the Tilebox command-line tool on your machine. ```bash Shell -curl -fsSL https://cli.tilebox.com/install.sh | sh +curl -fsSL https://install.tilebox.com/cli.sh | sh ```