Skills Reference
Contacts
What it does
Manages your contacts, communication channels, access control, and invite links. Tracks who can reach your assistant and through which channels.
Setup required
None for basic contact management. Google Contacts integration available via OAuth.
Permissions
- Google OAuth (optional, for importing Google Contacts)
- No macOS permissions needed
Common prompts
| You say... | What happens |
|---|---|
| “Add Alice as a contact” | Opens an add-contact form for you to confirm |
| “Delete Alice” / “Rename Alice” | Opens an edit or delete confirmation |
| “What's Jake's email?” | Searches contact details |
| “Send Alice an invite to connect on Telegram” | Generates a channel-specific invite link |
| “Import my Google Contacts” | Syncs contacts from Google |
| “Make Alice a trusted contact” | Grants access control privileges |
| “Block messages from this number” | Updates channel status |
Configuration
- Contacts can have multiple channels (Telegram, Slack, phone)
- Channel statuses: active, revoked, blocked
- Trusted contacts can interact with your assistant on your behalf
Tips & gotchas
- Access management. Contacts are how you manage who can reach your assistant through external channels.
- You approve every write. The assistant can look up and search contacts on its own, but creating, editing, deleting, merging, or adding a channel to one opens a form in your app first. Nothing is written until you submit it, and you can edit the values it proposes before you do.
- A contact is not access. Adding someone records who they are. It does not let them message your assistant: that takes a verified channel, through an invite they redeem themselves or an address you enter and verify.
- Trusted contacts. Making someone a “trusted contact” gives them limited access to your assistant: they can chat but can't access your memories or sensitive tools without guardian approval.
- Invite links. Invite links are channel-specific and can be revoked.