Quick start
From login to a verified round-trip in a few commands.
Step 1 — Log in
The CLI ships with built-in environments and logs into prod by default:
A browser opens for device authorization. Approve it, and your token is saved. Confirm:
It prints your user and namespace — note the namespace, you'll use it in targets below.
Step 2 — Create a project
Projects are private by default. Pass --public to share. The output
shows the project slug — use it in targets.
Step 3 — Upload a file
my-robots:run-001is a target:project[:episode].- The episode
run-001is created automatically if it doesn't exist. --tois the path inside the episode.
Step 4 — List and download
That's the full loop
Create → upload → list → download. From here, explore uploading (folders, resume), projects & data (bindrs, datasets), or organizations.
Targets at a glance
Most data commands take a target string:
| Form | Used by | Example |
|---|---|---|
project[@namespace] | --project | my-robots@alice |
project[@namespace][:episode] | --episode | my-robots@alice:run-001 |
@namespace is optional — it defaults to your own (from dreamlake profile).