Ravi Contacts

Manage contacts associated with your identity. Contacts store people you interact with — their email, phone, display name, and nickname.

Commands

CODEBLOCK0

Create/update fields: --email, --phone, --display-name, --nickname, INLINECODE4

JSON Shapes

ravi contacts list:
CODEBLOCK1

ravi contacts get <uuid>:
CODEBLOCK2

Resolving Recipients

When the user asks to email or text someone by name (e.g. "email Alice" or "text Bob"), always search contacts first to resolve their name to an email address or phone number:

CODEBLOCK3

This is the primary integration point with ravi-email-send and SMS workflows.

Key Concepts

• - Auto-contacts — Ravi automatically creates contacts from email and SMS interactions. When you send or receive a message, a contact is created or updated for the other party.
• Manual contacts — You can also create contacts manually via the CLI.
• Trusted contacts — Contacts marked with --is-trusted are classified as trusted senders. Emails from trusted contacts are routed to the email_trusted SSE channel, distinct from email_owner (your own emails) and email_untrusted (unknown senders). By default, contacts are not trusted.
• interaction_count — Tracks how many email/SMS interactions you have had with this contact. Auto-incremented by the system.
• last_interaction_dt — Timestamp of the most recent email or SMS interaction with this contact. Updated automatically.

Important Notes

• - Contacts are stored in plaintext — do not store sensitive information in contact fields. Use ravi-passwords for credentials and ravi-secrets for API keys.
• Auto-contacts from interactions — sending or receiving email/SMS automatically creates or updates contacts. You do not need to manually create contacts for people you interact with.
• Phone numbers in E.164 format — always include the country code (e.g., +15551234567).

Full API Reference

For complete endpoint details, request/response schemas, and parameters: Contacts

Related Skills

• - ravi-identity — Get your own email address and phone number
• ravi-passwords — Store website credentials (not contact info)
• ravi-secrets — Store API keys and env vars (not contact info)
• ravi-inbox — Read incoming email and SMS messages
• ravi-email-send — Send emails to your contacts