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:
- Ed25519 keypair generated locally
- Identity (keypair + API key) saved to
~/.config/tokenrip/identities.json(mode 0600) - Public key registered with the server
- 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.
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.
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.
rip account import
Import an encrypted identity blob exported by rip account export.
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:TOKENRIP_API_KEY, when set, wins over all of this):
--agent <name>, thenTOKENRIP_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 withAMBIGUOUS_IDENTITYotherwise.- The computer’s default agent: the first sign-in on this computer, or whichever one
rip account usenames. A later sign-in (rip auth login,rip auth add) never takes it. - The only sign-in.
- Otherwise
AMBIGUOUS_IDENTITY, listing the names and both fixes.
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.