hand contacts

Manage your contact list.

Synopsis

hand contacts list
hand contacts add <email>
hand contacts get <contact_id>
hand contacts update <contact_id> --alias <ALIAS>
hand contacts remove <contact_id>

Subcommands

contacts list

List all your contacts.

$ hand contacts list
ID                    EMAIL                     ALIAS         NAME
--------------------------------------------------------------------------------
contact-001...        alice@example.com         Alice         Alice Johnson
contact-002...        bob@example.com           Work Bob      Bob Smith
contact-003...        carol@example.com         -             Carol White

contacts add <email>

Add a new contact by email address.

$ hand contacts add colleague@example.com
Contact added: contact-004...

Note: The user must have a Handrive account. Use hand users invite to invite new users.

contacts get <contact_id>

Get detailed information about a contact.

$ hand contacts get contact-001
ID: contact-001...
Email: alice@example.com
Alias: Alice
Name: Alice Johnson
Avatar: https://...
Added: 2024-01-15 10:30:45

contacts update <contact_id>

Update a contact's alias (your personal nickname for them).

$ hand contacts update contact-002 --alias "Bob (Work)"
Contact updated

contacts remove <contact_id>

Remove a contact from your list.

$ hand contacts remove contact-003
Contact removed

Examples

Add a contact and discover their shares

# Add the contact
hand contacts add friend@example.com

# Discover shares they've shared with you
hand discovery shares friend@example.com

# List discovered shares
hand shares list --filter discovered

Organize contacts with aliases

# List contacts
hand contacts list

# Add descriptive aliases
hand contacts update contact-001 --alias "Alice (Design Team)"
hand contacts update contact-002 --alias "Bob (Engineering)"

Notes

Contacts are used for share discovery and member suggestions
Aliases are private and only visible to you
Removing a contact does not affect existing share memberships