Prefer backend-provided canonical link when available.

Manage the user's contacts, relationship graph, access control (trusted contacts), and invite links. This skill covers contact CRUD with multi-channel tracking, controlling who can message the assistant through external channels (Telegram, phone), and creating/managing invite links that grant access.

Contact Management

Contact writes are guardian-only. You can list, search, and merge contacts, but creating contacts and granting access happen through the guardian-facing flows: the Contacts tab in the assistant web UI for new contacts and channel verification, and assistant contacts invites create for invite-based onboarding. The LLM does not have a direct create/update tool — when a user asks for one, walk them to the guardian flow instead.

Search contacts

Search for contacts by name, channel address, or other criteria.

assistant contacts list --query "<search_term>" --json

Optional flags:

• --query -- search by display name (partial match)
• --channel-address -- search by channel address (email, phone, handle)
• --channel-type -- filter by channel type when searching by address
• --limit -- maximum results to return (default 50, max 100)

Merge contacts

When you discover two contacts are the same person (e.g. same person on email and Slack), merge them to consolidate. Merging:

• Combines all channels from both contacts
• Merges notes from both contacts
• Sums interaction counts
• Deletes the donor contact

assistant contacts merge <surviving_contact_id> <donor_contact_id> --json

Access Control (Trusted Contacts)

Trusted contacts control who is allowed to send messages to the assistant through external channels like Telegram and voice (phone calls).

Concepts