hand users

Profile management and user search.

Synopsis

hand users me
hand users update [--name <NAME>] [--avatar-url <URL>] [--metadata <JSON>]
hand users search <email>
hand users sync
hand users invite <email> [--message <MSG>]

Subcommands

users me

Display your current user profile.

$ hand users me
ID: user-abc123...
Email: you@example.com
Name: Your Name
Avatar: https://...
Created: 2024-01-01 00:00:00

users update

Update your profile information.

OptionDescription
--name <NAME>Your display name
--avatar-url <URL>URL to your avatar image
--metadata <JSON>Custom metadata as JSON
$ hand users update --name "John Doe"
Profile updated

$ hand users update --avatar-url "https://example.com/avatar.jpg"
Profile updated

$ hand users update --name "John" --metadata '{"theme": "dark"}'
Profile updated

Search for a user by email address.

$ hand users search colleague@example.com
ID: user-xyz789...
Email: colleague@example.com
Name: Jane Smith
Avatar: https://...

Returns user info if they exist, or suggests sending an invitation.

users sync

Sync user profiles from the server. Updates cached information for yourself, contacts, and share members.

$ hand users sync
Syncing profiles...
Updated: 5 profiles

users invite <email>

Invite a new user to Handrive.

OptionDescription
--message <MSG>Personal message to include in the invitation
$ hand users invite newuser@example.com
Invitation sent to newuser@example.com

$ hand users invite friend@example.com --message "Join me on Handrive!"
Invitation sent with custom message

Examples

Set up your profile

# View current profile
hand users me

# Update your name and avatar
hand users update --name "John Doe" --avatar-url "https://example.com/me.jpg"

# Verify changes
hand users me

Find and invite users

# Search for existing user
hand users search colleague@example.com

# If not found, send invitation
hand users invite colleague@example.com --message "Let's share files!"

# Once they join, add as contact
hand contacts add colleague@example.com

Notes

  • Profile changes are synced to the server immediately
  • Use users sync to refresh cached profile data
  • Invited users receive an email with signup instructions

See Also