i99dash docs
Operator CLI

Sign in

SSH-key login for i99op, registering keys, and checking your operator wallet balance.

i99op signs in with an SSH key — the same model as the i99dash SDK. You register a public key once in the web console, and i99op login proves you hold the private key by signing a one-time challenge. Your private key never leaves your machine.

First sign-in

Generate a key (skip if you have one)

ssh-keygen -t ed25519

Only ed25519 keys are supported.

Register the public key

Add the contents of ~/.ssh/id_ed25519.pub in the web console (Account → SSH keys). The CLI can't register your first key for you — it isn't authenticated yet.

Sign in

i99op login

It prompts for the backend URL (default https://i99op.i99dash.app), then signs the challenge and stores the token. Flags:

  • --base <url> — set / change the backend URL.
  • --key <path> — non-default private key (default ~/.ssh/id_ed25519).
  • --passphrase <pass> — for an encrypted key.
  • --token <value> — paste a credential directly, skipping the SSH flow.

Check your state with i99op config. Sign out with i99op logout (clears the stored token).

Staying signed in

The token you get at login is short-lived (about 15 minutes) — long enough that a quiet support session would otherwise drop mid-flight. You don't have to think about it: i99op re-mints the token automatically from your SSH key whenever it expires. The first call that hits an expired token silently re-signs the challenge and retries, so long sessions, recordings, and reconnects just keep working.

This is why there's no "refresh token" to manage — your SSH key is the renewal. The only requirement is that i99op can still reach your key:

  • An unencrypted key works across restarts — i99op remembers its path and re-signs whenever needed.
  • An encrypted key needs its passphrase in memory, so after a full restart sign in once (i99op login) to prime it.

Managing keys

Once you're signed in you can register more keys from the CLI (a second laptop, a teammate's machine):

i99op keys add ~/.ssh/id_ed25519.pub --name "work laptop"
i99op keys list
CommandWhat it does
i99op keys add <pub> [--name <label>]Register an OpenSSH public key on your account.
i99op keys listList your registered keys with fingerprints + last-used time.

i99op keys add only works once you're already signed in — it's for additional keys. The very first key must be added in the web console.

Wallet balance

Each support ticket is a flat charge against your operator wallet. Check your balance from the terminal; top up in the web console:

i99op balance

See Run a session for what gets billed.

On this page