Authentication

Browser (default)
Email code
Password

jstm login

Opens your browser to a verification page showing a user code, then polls until you approve. This is the same device flow used by gh and similar tools.If you can’t open a browser — a remote shell, a container — add --no-browser and the CLI prints the URL and code for you to open elsewhere.

jstm login --no-browser

jstm login --email dana@acme.com

Sends a one-time code to that address and verifies it in the terminal. No browser involved.To skip the interactive prompt — in a script, or when you already have the code:

jstm login --email dana@acme.com --otp 481920

jstm login --email dana@acme.com --password

Password login is deprecated and prints a deprecation warning. Use the browser or email-code flow.

Option	Description
`--email`, `-e`	Email address. Sends a login code to it
`--password`, `-p`	Password. Deprecated
`--otp`	Login code, skipping the interactive prompt
`--no-browser`	Print the URL and code instead of opening a browser
`--json`	Emit the result as JSON

On success, your session is written to session.json with 0600 permissions. See Configuration for where that file lives.

In CI, set JOYSTREAM_TOKEN instead of logging in. It takes precedence over the session file.

`jstm logout`

Clear the stored session.

jstm logout
jstm logout --json

`jstm whoami`

Show the current user and workspace context. This is the fastest way to confirm you’re signed in and pointed at the right workspace.

jstm whoami
jstm whoami --json

If it reports a session problem, run jstm login again.

`jstm commands`

Print every command and subcommand as a table. Useful when you want the whole surface at once.

jstm commands

This command has no --json.

Using the CLI

Commands

`jstm logout`

`jstm whoami`

`jstm commands`

​jstm login

​jstm logout

​jstm whoami

​jstm commands

`jstm login`

`jstm logout`

`jstm whoami`

`jstm commands`