Skip to content

quox contacts

Documented Checked against the CLI's current help and source. Not run end to end. Last checked on quoxcli 0.6.1, 2026-11-10.

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 send [options] <contact> <text>Send an SMS or email to a contact now, or at a time with --at (the server delivers it; the answer says exactly when)
quox contacts scheduledScheduled sends: what is queued, and cancel one before it goes out
quox contacts scheduled list [options]
quox contacts scheduled cancel <id>
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 grant list
quox contacts grant add [options] <agent>
quox contacts grant revoke <grant-id>
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 retention statusReaper status: enabled, last run, next run, pending
quox contacts retention run [options]Run the reaper now (org admin). --dry-run lists what would be erased and changes nothing
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 sync listList sync sources with last run and status
quox contacts sync add [options]Add a sync source from a vault credential of kind carddav_account (create the credential first; for iCloud use an app-specific password)
quox contacts sync run [options] <id>Pull the address book now. --dry-run reports counts and changes nothing
quox contacts sync enable <id>Enable a source for scheduled sync (also clears a retirement after repeated failures)
quox contacts sync disable <id>Stop scheduled sync for a source (contacts are kept)
quox contacts sync remove [options] <id>Remove a sync source: stops syncing, keeps every contact already pulled
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)