nanocontacts

name	nanocontacts
description	Search, view, create, and update contacts with the nanocontacts CLI. Use when working on a Mac where nanocontacts is installed and you need Apple Contacts data or updates from the terminal.

nanocontacts CLI

Use nanocontacts directly. Always pass --json for structured output.

Read

nanocontacts me --json                           # your own contact card
nanocontacts groups --json
nanocontacts search "Jenny" --limit 10 --json   # searches name and organization
nanocontacts show --id "UUID:ABPerson" --json

Write

nanocontacts create --first "Jane" --last "Doe" --email "[e-mail]" --phone "[phone]" --json
nanocontacts update --id "UUID:ABPerson" --first "Jane" --last "Smith" --json
nanocontacts update --id "UUID:ABPerson" --add-email "[e-mail]" --json
nanocontacts update --id "UUID:ABPerson" --add-phone "[phone]" --json

Workflow

1. Search before creating to avoid duplicates.
2. Use IDs from search results for show and update.
3. Ask for missing details before creating a new contact.
4. Ask for confirmation before creating or updating contacts.