Prerequisites
- Node.js 20 or newer.
- A personal API key (the
up_...kind), from Account > Developer.
Steps
1
Install the CLI
2
Log in
up_... key when prompted. The input is hidden. Confirm who you are with:3
Find your studio
id of the studio you want to work in. Most commands take it as their first argument.4
Read a session list
--agent gives you raw JSON you can pipe.5
Make your first write
Preview any write with When the request looks right, run it for real:
--dry-run. It prints the request without actually sending it:Writes against production ask you to confirm. In a script, where nobody is around to answer, the write is refused. Pass
--yes to skip the prompt.Next steps
Authentication
Keep several accounts, and use a key in CI.
Global options
Agent mode, dry runs, and write guards.
Command reference
Every command, argument, and flag.
Troubleshooting
Fix login problems and blocked writes.