Ravi

When to Use

A personal-agent setup (many agents, one human) where the agent hits a login and has to stop and hand the human the browser. If each agent had its own Ravi identity (inbox, phone, vault), it would not. Same identity fills the form, waits on the signup OTP, handles returning-login 2FA, and stores the password for the next worktree.

Ravi gives AI agents their own identity (email inbox, real phone, encrypted vault) so they can sign up for services, receive verification codes, and keep the passwords they create. For teams whose agents have to act on the web, not just talk.

Creating that identity: Sign Up (https://docs.ravi.app/getting-started/sign-up.txt). Keys and device-code login: Authentication (https://docs.ravi.app/getting-started/authentication.txt).

Chat vs identity

A chat-only agent answers questions. It does not own an email address, a phone number, or a password store. That is enough for research and drafting. It is not enough when the agent has to act on the web: create an account, confirm a signup email, complete a returning login, or reuse a password it created in another session.

Give the agent its own identity when it must:

  • Fill a signup form as a real person-shaped account
  • Wait on the signup OTP or magic link the service sends
  • Handle returning-login 2FA by receiving the second factor
  • Store the password it created so a later worktree can use it

An identity is the persona the agent operates as. It owns an email inbox, a phone number, and an encrypted vault. Create one with a management key (ravi_mgmt_...) after signup, then mint an identity-scoped key (ravi_id_...) for the runtime. Device-code login (ravi auth login) against https://api.ravi.app is the local CLI path. The CLI is one identity per machine (~/.ravi/config.json is not a multi-agent runtime). Multiple agents on one host use the HTTP API with per-identity ravi_id_... keys.

Next Steps

  • Your agent hit a login wall (https://docs.ravi.app/getting-started/login-wall.txt)
  • How an agent signs up for a website (https://docs.ravi.app/getting-started/sign-up-for-a-service.txt)
  • Sign Up — account, first identity, and keys (https://docs.ravi.app/getting-started/sign-up.txt)
  • Authentication — ravi_mgmt_... / ravi_id_... and device-code login (https://docs.ravi.app/getting-started/authentication.txt)
  • Status — API and docs availability