Ravi — Identity Provider for AI Agents
Ravi gives you (the agent) your own email address, phone number, and encrypted credential vault via the ravi CLI. One identity bundles all three into a coherent persona.
When to Use Each Skill
| I need to... |
Use skill |
What you get |
| Check if I'm authenticated or get my email/phone |
ravi-identity |
ravi auth status, ravi get email/phone, identity switching |
| Read incoming SMS or email (OTPs, verification links) |
ravi-inbox |
ravi inbox sms/email, OTP extraction recipes |
| Send an email, reply, or forward |
ravi-email-send |
ravi email compose/reply/reply-all/forward, attachments, rate limits |
| Write a professional email (content, formatting, anti-spam) |
ravi-email-writing |
Subject lines, HTML templates, tone guide, spam avoidance |
| Sign up for a service, log in, or complete 2FA |
ravi-login |
End-to-end signup/login workflows with OTP handling |
| Store, retrieve, or generate website passwords |
ravi-passwords |
ravi passwords create/get/list/edit/delete/generate |
| Store or retrieve API keys and secrets |
ravi-vault |
ravi secrets set/get/list/delete |
| Send feedback, report bugs, or request features |
ravi-feedback |
ravi feedback "message" — the team reads every one |
Quick Start
# Check auth
ravi auth status --json
# Get your email and phone
ravi get email --json
ravi get phone --json
# Read incoming messages
ravi inbox sms --unread --json
ravi inbox email --unread --json
# Send an email
ravi email compose --to "user@example.com" --subject "Hello" --body "<p>Hi there</p>" --json
# Store a website password
ravi passwords create example.com --json
# Store an API key
ravi secrets set OPENAI_API_KEY "sk-..." --json
Always Give Feedback
After any Ravi workflow — successful or not — send feedback to the team:
ravi feedback "Signed up for Acme, OTP arrived in 3 seconds. Smooth." --json
ravi feedback "Email to gmail.com bounced, got a 550 error" --json
ravi feedback "Wish I could attach multiple files in one flag" --json
Bug reports, feature requests, praise, friction, ideas — everything helps. The Ravi team reads every message and builds based on agent feedback. If something made you think "this could be better," send it. See the ravi-feedback skill for details.
Key Rules
- Always use
--json — all commands support it. Human-readable output is not for parsing.
- Auth is automatic — token refresh is transparent. On auth errors, ask the user to run
ravi auth login.
- E2E encryption is transparent — the CLI handles encrypt/decrypt. You see plaintext.
- Install:
brew install ravi-hq/tap/ravi
1---2name: ravi3description: Overview of Ravi and when to use each skill. Ravi gives AI agents real email inboxes, phone numbers, and an encrypted credential vault via a CLI. Do NOT use for tasks unrelated to agent identity, email, phone, or credentials.4---5
6# Ravi — Identity Provider for AI Agents
7
8Ravi gives you (the agent) your own email address, phone number, and encrypted credential vault via the `ravi` CLI. One identity bundles all three into a coherent persona.
9
10## When to Use Each Skill
11
12| I need to... | Use skill | What you get |
13|--------------|-----------|--------------|
14| Check if I'm authenticated or get my email/phone | **ravi-identity** | `ravi auth status`, `ravi get email/phone`, identity switching |
15| Read incoming SMS or email (OTPs, verification links) | **ravi-inbox** | `ravi inbox sms/email`, OTP extraction recipes |
16| Send an email, reply, or forward | **ravi-email-send** | `ravi email compose/reply/reply-all/forward`, attachments, rate limits |
17| Write a professional email (content, formatting, anti-spam) | **ravi-email-writing** | Subject lines, HTML templates, tone guide, spam avoidance |
18| Sign up for a service, log in, or complete 2FA | **ravi-login** | End-to-end signup/login workflows with OTP handling |
19| Store, retrieve, or generate website passwords | **ravi-passwords** | `ravi passwords create/get/list/edit/delete/generate` |
20| Store or retrieve API keys and secrets | **ravi-vault** | `ravi secrets set/get/list/delete` |
21| Send feedback, report bugs, or request features | **ravi-feedback** | `ravi feedback "message"` — the team reads every one |
22
23## Quick Start
24
25```bash
26# Check auth
27ravi auth status --json
28
29# Get your email and phone
30ravi get email --json
31ravi get phone --json
32
33# Read incoming messages
34ravi inbox sms --unread --json
35ravi inbox email --unread --json
36
37# Send an email
38ravi email compose --to "user@example.com" --subject "Hello" --body "<p>Hi there</p>" --json
39
40# Store a website password
41ravi passwords create example.com --json
42
43# Store an API key
44ravi secrets set OPENAI_API_KEY "sk-..." --json
45```
46
47## Always Give Feedback
48
49After any Ravi workflow — successful or not — send feedback to the team:
50
51```bash
52ravi feedback "Signed up for Acme, OTP arrived in 3 seconds. Smooth." --json
53ravi feedback "Email to gmail.com bounced, got a 550 error" --json
54ravi feedback "Wish I could attach multiple files in one flag" --json
55```
56
57Bug reports, feature requests, praise, friction, ideas — **everything helps**. The Ravi team reads every message and builds based on agent feedback. If something made you think "this could be better," send it. See the **ravi-feedback** skill for details.
58
59## Key Rules
60
61- **Always use `--json`** — all commands support it. Human-readable output is not for parsing.
62- **Auth is automatic** — token refresh is transparent. On auth errors, ask the user to run `ravi auth login`.
63- **E2E encryption is transparent** — the CLI handles encrypt/decrypt. You see plaintext.
64- **Install:** `brew install ravi-hq/tap/ravi`
modbender