Skip to main content
Install the CLI, log in, read some sessions, then make your first write.

Prerequisites

  • Node.js 20 or newer.
  • A personal API key (the up_... kind), from Account > Developer.

Steps

1

Install the CLI

You should see the list of topics and commands.
2

Log in

Paste your up_... key when prompted. The input is hidden. Confirm who you are with:
3

Find your studio

Note the id of the studio you want to work in. Most commands take it as their first argument.
4

Read a session list

The plain command prints a table. Adding --agent gives you raw JSON you can pipe.
5

Make your first write

Preview any write with --dry-run. It prints the request without actually sending it:
When the request looks right, run it for real:
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.
The playtest is now a draft. The CLI cannot publish it: open the studio to do that.

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.