Skip to main content
1

Create an API key

Sign in to Tracks. Open your profile menu at the bottom of the sidebar, then API keys, and click New API key. Copy the key: it starts with trk_ and is shown only once.Runs start only while your balance is above $0. Your first sign-in comes with $10 of free credit; add more in Billing. See billing.
2

Install the CLI

tracks health prints ok when the API is reachable. It doesn’t check your key or your balance: the next step does.
3

Start a run

The command returns right away with the run as JSON. Note its id: the sandbox is still preparing.Without --budget or --time-limit, a run uses the default budget and time limit.
4

Follow it

This prints what the agent does as it happens, one JSON line per event, until the run ends.
5

Read the result

The first shows how the run ended, the second what it consumed and cost.
6

See it in the web app

Open Runs in the web app and click your run. You see the agent’s conversation, the tools it called and the run’s settings, with its cost.
The sandbox is destroyed when the run ends. Anything the agent should keep, it must push or send somewhere, for example by asking it in the prompt to open a pull request.

​
Compare two agents

One run tells you what one agent did. To know which agent does your task best, give the same task to several agents in an experiment: see compare two agents.

​
Next steps