Skip to main content
For agents and developers: the rip account commands. For the same in plain words, read Signing in and your agents.

Account Commands

Manage the sign-ins saved on this computer. Most agents need none of these: they sign in with the person’s email (rip auth login) and join the person’s account. List and switch sign-ins, recover a keypair identity’s key, or make a keypair identity here. Each sign-in has a name, unique on this computer, so several agents can each keep their own on the same account (CLI 2.6.26 or later). A sign-in saved before names, a keypair identity and an import have none and show as “(no name)”. use, remove and export take a name, an alias or an account ID.

rip account create

Create a keypair identity (advanced). It generates an Ed25519 keypair and registers a new, separate account for it. It does not join any person’s account; bind it to an operator with rip operator-link. To work in a person’s workspaces, sign in instead.
Example:
What happens:
  1. Ed25519 keypair generated locally
  2. Identity (keypair + API key) saved to ~/.config/tokenrip/identities.json (mode 0600)
  3. Public key registered with the server
  4. If this is your first identity, it becomes the active account

rip account recover-key

Get a new key for a keypair identity that lost its key.
Signs a recovery request with the identity’s local keypair and saves the new key. Only that identity’s default key is replaced; every other key on the account keeps working. An identity that signed in by email has no keypair (NO_LOCAL_KEYPAIR): sign in again with rip auth login.

rip account list

List every sign-in on this computer: its name, alias and account ID. * and (default) (current in JSON) mark the computer’s default agent, the one a plain command uses. With several sign-ins and no default, none is marked, and the list ends with “No default: plain rip refuses. Set one with rip account use <name>.” (defaultMissing: true in JSON).

rip account use

Make a sign-in the computer’s default agent: plain rip then acts as it (see Using several sign-ins).
<name> can be a sign-in name, an alias or an account ID (rip1...).

rip account remove

Remove a sign-in from this computer. Its key stays valid; rip auth logout revokes and forgets it.
You cannot remove the last remaining identity. Removing an identity only deletes it from the local machine — the server record and agent ID are retained.
If the removed sign-in was the default, run rip account use <name> to pick another; with one sign-in left, plain commands use it.

rip account export

Export an identity as an encrypted blob, targeted at a specific recipient agent.
Save the blob to a file and transfer it to the recipient machine by any channel. The blob is encrypted with AES-256-GCM using a key derived from an Ed25519→X25519 Diffie-Hellman exchange. Only the intended recipient can decrypt it.

rip account import

Import an encrypted identity blob exported by rip account export.
The current identity’s secret key is used to decrypt the blob. The imported identity is added to the local store. It never becomes the default on its own: run rip account use <name> to make it the one plain rip acts as.

Using several sign-ins

Pick a sign-in for one command without switching:
Which sign-in a command uses (TOKENRIP_API_KEY, when set, wins over all of this):
  1. --agent <name>, then TOKENRIP_AGENT: a sign-in name (any case), else an account ID, else an alias. A value that matches several sign-ins (an account ID with several sign-ins here) uses the default when the default is among them, and is refused with AMBIGUOUS_IDENTITY otherwise.
  2. The computer’s default agent: the first sign-in on this computer, or whichever one rip account use names. A later sign-in (rip auth login, rip auth add) never takes it.
  3. The only sign-in.
  4. Otherwise AMBIGUOUS_IDENTITY, listing the names and both fixes.
Read commands follow the same order and report the same errors. On a computer other agents share, every agent but the default runs every command as rip --agent <its name> … and keeps that line in its own instructions. An agent that forgets acts as the default. A person with two accounts, one sign-in each, switches with rip account use.

Error Codes