# Ravi Contacts

> Manage contacts associated with your identity — list, search, create,

- Skill: `dvcrn/ravi-contacts` (Agent Skill)
- Install (CLI): `npx skillmds@latest add dvcrn/ravi-contacts`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/ravi-contacts/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/ravi-contacts

---


# Ravi Contacts

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

## Commands

```bash
# List all contacts
ravi contacts list --json

# Fuzzy search contacts by name or email (phone is not fuzzy-searched)
ravi contacts search "alice" --json

# Get a single contact
ravi contacts get <uuid> --json

# Create a contact
ravi contacts create --email "alice@example.com" --display-name "Alice Smith" --json
ravi contacts create --phone "+15551234567" --nickname "alice" --json
ravi contacts create --email "bob@corp.com" --phone "+15559876543" --display-name "Bob Jones" --nickname "bob" --json

# Create a trusted contact
ravi contacts create --email "alice@example.com" --display-name "Alice" --trusted --json

# Mark existing contact as trusted
ravi contacts update <uuid> --trusted --json

# Update a contact
ravi contacts update <uuid> --nickname "ally" --json
ravi contacts update <uuid> --email "newemail@example.com" --display-name "Alice S." --json

# Delete a contact
ravi contacts delete <uuid> --json
```

**Flags:** `--email`, `--phone`, `--display-name`, `--nickname`, `--trusted`

## JSON Shapes

**`ravi contacts list --json`:**
```json
[
  {
    "uuid": "...",
    "email": "alice@example.com",
    "phone_number": "+15551234567",
    "display_name": "Alice Smith",
    "nickname": "alice",
    "is_trusted": false,
    "source": "auto",
    "interaction_count": 5,
    "last_interaction_dt": "2026-03-01T14:00:00Z",
    "created_dt": "2026-02-20T10:30:00Z"
  }
]
```

**`ravi contacts get <uuid> --json`:**
```json
{
  "uuid": "...",
  "email": "alice@example.com",
  "phone_number": "+15551234567",
  "display_name": "Alice Smith",
  "nickname": "alice",
  "is_trusted": false,
  "source": "auto",
  "interaction_count": 5,
  "last_interaction_dt": "2026-03-01T14:00:00Z",
  "created_dt": "2026-02-20T10:30:00Z",
  "updated_dt": "2026-02-28T09:15:00Z"
}
```

**`ravi contacts create --json` (request body):**
```json
{
  "email": "alice@example.com",
  "phone_number": "+15551234567",
  "display_name": "Alice Smith",
  "nickname": "alice",
  "is_trusted": false
}
```

## 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:

```bash
# Step 1: Search by name
ravi contacts search "Alice" --json

# Step 2: If one match → use the email/phone from the result
# Step 3: If multiple matches → confirm with the user which one they mean
# Step 4: If no matches → ask the user for the email/phone directly
```

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 with `ravi contacts create`.
- **Trusted contacts** — Contacts marked with `--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 (`is_trusted: false`).
- **`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`).
- **Always use `--json`** — human-readable output is not designed for parsing.

## 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