Skip to content
arpi docs

Quick Start

This guide walks you from install to your first completed worker trajectory in about 5 minutes.

Step 1: Install the CLI

Section titled “Step 1: Install the CLI”
Terminal window
brew install sharpi-ai/tap/arpi

Verify installation:

Terminal window
arpi version

Step 2: Authenticate

Section titled “Step 2: Authenticate”
Terminal window
arpi auth login

This opens your browser for OIDC authentication. Once complete, your CLI session is authenticated.

Step 3: Create a template

Section titled “Step 3: Create a template”

Save the following as hello.toml:

template_version = "1.0"


[worker]
name = "hello-worker"


[workstation]
model = "claude-sonnet-4-20250514"
task = "Say hello and list 3 interesting facts about AI workers."


[workstation.capabilities]
mcps = []

Templates are the source of truth for worker configuration. The [worker] section names the worker, [workstation] sets the model and task, and [workstation.capabilities] declares what tools the worker can access.

Step 4: Spawn the worker

Section titled “Step 4: Spawn the worker”
Terminal window
arpi spawn hello.toml

You’ll get back a worker ID:

Worker spawned: wrk_a1b2c3d4

The worker transitions through Pending -> Spawned -> Running -> Completed as it executes the task.

Step 5: View the trajectory

Section titled “Step 5: View the trajectory”
Terminal window
arpi trajectory wrk_a1b2c3d4

The trajectory shows every step the worker took — actions, tool calls, durations, and costs.

You can also view trajectories in the web dashboard at https://app.arpi.sh under Space > Track.

Next steps

Section titled “Next steps”