hand discovery

Discover shares from other devices.

Synopsis

hand discovery shares <email>

Description

The discovery command finds shares that are available to you from other devices. This includes:

  • Self-discovery: Use your own email to find shares from your other devices
  • Contact discovery: Use a contact's email to find shares they've shared with you

Subcommands

discovery shares <email>

Discover shares from a user's devices.

$ hand discovery shares me@example.com
Discovering shares from me@example.com...
Found 3 shares from 2 devices

Use 'hand shares list --filter discovered' to see discovered shares.
$ hand discovery shares colleague@example.com
Discovering shares from colleague@example.com...
Found 1 share from 1 device

Examples

Self-discovery (find your own shares)

# If you have Handrive on multiple devices, discover shares from them
hand discovery shares your@email.com

# List discovered shares
hand shares list --filter discovered

# Sync file metadata from a discovered share
hand files discover <share_id>

# List the files
hand files list <share_id>

Discover shares from a contact

# Add the contact first
hand contacts add colleague@example.com

# Discover their shares
hand discovery shares colleague@example.com

# View what was found
hand shares list --filter discovered

# Sync and browse
hand files discover <share_id>
hand files list <share_id>

Complete workflow: Access shared files

# 1. Someone shares files with you (they run):
#    hand members add <their_share> your@email.com

# 2. You discover their share:
hand discovery shares their@email.com

# 3. Sync the file metadata
hand files discover <share_id>

# 4. Browse files
hand files list <share_id>
hand files search <share_id> "document"

# 5. Download what you need
hand transfers download <device_id> ~/Downloads \
    --source-share <share_id> \
    --files "file1,file2"

How Discovery Works

  1. Handrive queries the server for devices belonging to the specified email
  2. For each online device, it requests the list of shares
  3. Shares where you are a member (viewer, editor, or owner) are returned
  4. Discovered shares appear in hand shares list --filter discovered

Notes

  • Discovery only works when the remote device is online
  • You can only discover shares where you have been added as a member
  • Use hand shares list --filter discovered to see results
  • Run hand files discover to fetch file metadata from discovered shares

See Also