hand shares

Create and manage file shares.

Synopsis

hand shares list [--filter <FILTER>]
hand shares create <name> <path> [--description <DESC>]
hand shares get <share_id>
hand shares update <share_id> [--name <NAME>] [--description <DESC>]
hand shares delete <share_id>
hand shares online <share_id>

Subcommands

shares list

List all shares accessible to you.

Option	Description
`--filter <FILTER>`	Filter by type: `all`, `local`, `remote`, `discovered`

$ hand shares list
ID                                    NAME              PATH
--------------------------------------------------------------------------------
abc123-def456-789...                  My Documents      /Users/me/Documents
xyz789-abc123-456...                  Project           /Users/me/project

$ hand shares list --filter local
# Shows only shares on this device

shares create <name> <path>

Create a new share from a local directory.

Option	Description
`--description <DESC>`	Optional description for the share

$ hand shares create "My Documents" /Users/me/Documents
Share created: abc123-def456-789...

$ hand shares create "Project" ./project --description "Work files"
Share created: xyz789-abc123-456...

shares get <share_id>

Get detailed information about a share.

$ hand shares get abc123
ID: abc123-def456-789...
Name: My Documents
Description: Personal files
Local Path: /Users/me/Documents
Device ID: device-123...
Local: true
Created: 2024-01-15 10:30:45
Updated: 2024-01-15 10:30:45

shares update <share_id>

Update share properties.

Option	Description
`--name <NAME>`	New name for the share
`--description <DESC>`	New description

$ hand shares update abc123 --name "Documents"
Share updated

$ hand shares update abc123 --name "Docs" --description "All documents"

shares delete <share_id>

Delete a share. This removes the share from Handrive but does not delete the actual files.

$ hand shares delete abc123
Share deleted

shares online <share_id>

Check if the device hosting a share is currently online.

$ hand shares online abc123
Online: true
Device: device-123...
Last seen: 2024-01-15 10:30:45

Share Types

Local - Shares on this device that you own
Remote - Shares on other devices that you have access to
Discovered - Shares found via discovery that haven't been synced yet

Examples

Create and share a folder

# Create the share
hand shares create "Photos" ~/Pictures

# Add a member
hand members add <share_id> friend@example.com --role viewer

List remote shares

# See shares others have shared with you
hand shares list --filter remote