Creating your first agent run

A run is the basic unit of work in Y0: one agent, one context, one auditable execution. Your first one takes about five minutes, and most of that is authentication.

Install and authenticate

The CLI is the fastest path. Install it, then log in — the browser handshake issues a short-lived token scoped to your workspace.

npm install -g @mynd/cli
y0 auth login

Start a run

Every run needs a context — the slice of your connected data the agent is allowed to see. If you have not connected anything yet, the starter context works with sample data.

y0 run --context starter/demo

What happens next

• ↳The runtime loads the context and prints exactly what was loaded — no silent access.
• ↳The agent executes, and each step is written to the run log as it happens.
• ↳You get a run ID. Keep it: y0 trace <run-id> replays the whole execution.

That is the loop. Connect a real context next — calendar and docs are the two that make the product click — and read the context permissions article before you grant anything broad.