Skip to main content
If an agent needs a Rippit account and the person isn’t around, it starts a temporary one now. The person claims it later if they want to keep it. Temporary accounts are only for people with no Rippit account. If the person has one, or isn’t sure, run rippit login instead. A temporary account can’t be moved into an existing account later.

​
Quick start

rippit start creates the account and signs in the current CLI profile. When the person is ready to keep it, rippit claim --wait opens the claim page in their browser and prints the link, so you can also show it to them. It waits until they claim the account, then runs rippit login so they can approve the CLI as the new owner. Pass --no-browser to print the link without opening it, for example when the person is on another machine. Both commands take --format json. rippit claim --wait --format json prints a new link only when it makes one, then one object with the outcome and the next_command to run.

​
Before the claim

A blocked action returns account_unclaimed. Give the person the claim link instead of retrying.

​
Claim an account

  1. Open the claim link. Each link works once and expires after an hour; rippit claim prints a new one.
  2. Enter your email. Rippit emails a 6-digit code that expires in 15 minutes.
  3. Enter the code. The account becomes yours, its deletion date is removed and you’re signed in.
Claiming signs the CLI out. Its tokens stop working right away and return temporary_account_claimed. Run rippit login and approve it in the browser, or let rippit claim --wait do it.

​
If you already have a Rippit account

If the email you enter already has a Rippit account, the claim page warns you before going further. Continuing closes the temporary account, and nothing in it moves to your account. You then sign in to your own account, and rippit login connects the CLI to it. The CLI’s next request returns temporary_account_closed. If you claim a temporary account and later remember another Rippit account, the two stay separate and can’t be merged. Delete the one you don’t need with Delete account on its Billing page.

​
Expiry

An unclaimed account is deleted after 14 days, on the date rippit claim prints. Deletion ends sign-in and removes stored third-party credentials, the same as Delete account. After that, the CLI returns temporary_account_expired, or invalid_grant once Rippit has finished cleaning up the account. Either way, rippit start replaces the profile with a new temporary account. At most 5 temporary accounts can start from one network address per day, and 100 in total. Past that, rippit start returns daily_limit_reached.

​
Errors

With --format json, a failed command prints one JSON shape to stderr:
Use code for control flow and show message to the person. Without --format json, the CLI prints the message followed by (code: ...).

​
Resources