contacts

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. ```bash 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 ```bash assist...