Skip to content

quox contacts

Documented Checked against the CLI's current help and source. Not run end to end. CLI 0.3.1, checked 2026-10-13.

All commands

ContactsQ: governed contacts (add, find, resolve caller-ID, suppress)

CommandWhat it does
quox contacts add [options] [name]Create a contact (repeat --phone/--email for several identifiers). Name: positional <name> (split into given/family) or --given/--family/…
quox contacts edit [options] <id>Edit a contact name (partial: only the parts you pass change; --given ” clears one)
quox contacts list [options]List contacts
quox contacts find [options] <text>Find contacts by name (same as list --q)
quox contacts show [options] <id>Show a contact card (masked). --greeting: safe greeting projection. --full: raw identifiers, human only
quox contacts resolve [options] <value>Caller-ID: resolve a phone number or email to a contact (reports suppression)
quox contacts add-id [options] <id>Add an identifier to a contact
quox contacts archive <id>Archive a contact (not erasure)
quox contacts suppress [options] <value>Add a number or email to the suppression list (blind index only)
quox contacts suppressed [options] <value>Check whether a number or email is suppressed
quox contacts search [options] <text>Ranked name search (phonetic: Sean/Shawn/Shaun); flags ambiguity instead of guessing
quox contacts briefMorning brief: candidates to review, consents expiring, overdue notices, duplicates, sync health, recent do-not-call additions
quox contacts timeline [options] <id>Interaction history of a contact, newest first: surface, direction, outcome and time (refs only, no message bodies)
quox contacts best-channel [options] <id>Which channel (voice, email or sms) may be used to reach a contact for a purpose, with every alternative and its reason codes. Read-only; never shows a number or address
quox contacts count [options]How many contacts: the total (people and organisations, not archived or erased) with counts by kind, status and relationship. --kind narrows to person or organisation
quox contacts selftest [options]Drive the read path (search, find, resolve, best channel, timeline, touchpoint, brief) against a demo contact. Never dials or sends. --agent runs it through the attached agent tool scope
quox contacts handoff <id> <note>Leave a handoff note on a contact with an open thread (stored encrypted, humans read it)
quox contacts handoffs [options] <id>Open handoff notes on a contact, newest first
quox contacts focusShow the contact currently open in the ContactsQ dashboard (the one an agent means by “this person”); expires after 30 minutes
quox contacts call [options] <id>Dial a contact by id through the phone bridge; you never see or type the number
quox contacts leases <id>Lease + use ledger for a contact (who was given access, when, why; never the values)
quox contacts grantStanding grants: let an agent reach contacts without asking each time (admin)
quox contacts dsar [options] <id>Data subject access request: the full record, provenance, consents, touchpoints, edges and the lease use ledger as one JSON bundle (org admin)
quox contacts erase [options] <id>Erase a contact (org admin, irreversible). full = crypto-shred + tombstone; identifiers_only keeps the record
quox contacts certificate <erasure-id>Print an erasure certificate (org admin)
quox contacts complianceCompliance bands: Article 14 notices overdue, candidates expiring, no lawful basis, consents expiring
quox contacts notice-sent [options] <id>Record that the Article 14 notice was sent to a contact
quox contacts processing-record [options]Article 30 record of processing for this org (no personal data; org admin)
quox contacts retentionRetention reaper: erases candidates past their retention date (kill switch: contacts settings --reaper off)
quox contacts import [options] <file>Import contacts from a CSV (incl. Google Contacts export) or vCard file. Dry run unless --commit. Org admin
quox contacts syncLink an address book (iCloud or any CardDAV) and pull it into ContactsQ, one way. Org admin
quox contacts merge [options] <survivor> <loser>Merge LOSER into SURVIVOR (org admin, undoable for 30 days with contacts unmerge)
quox contacts unmerge <merge-id>Undo a merge (org admin, within 30 days): both contacts are restored exactly
quox contacts duplicatesSuggest duplicate pairs (same identifier, or same name at the same organisation)
quox contacts facts [options] <id>List a contact’s facts (human). --confirm / --reject <fact-id> reviews an agent proposal
quox contacts settings [options]Show or update ContactsQ settings (updates are admin only)
quox contacts unblock [options] <identifier>Lift an erasure tombstone so a returning person can be re-added (org admin; witnessed)
quox contacts rewrapRe-wrap every contact key under the current master key and upgrade old ciphertexts (org admin)
quox contacts reindexRe-key every blind index under the current master key (master-key rotation step; org admin)
quox contacts strict-names <action>Apply the org strict_names setting to existing contacts, both directions (org admin)