hand members

Manage share access and member permissions.

Synopsis

hand members list <share_id>
hand members add <share_id> <email> [--role <ROLE>] [--name <NAME>]
hand members update <share_id> <member_id> --role <ROLE>
hand members remove <share_id> <member_id>

Roles

RolePermissions
ownerFull control, can delete share and manage all members
editorRead, write, delete files; cannot manage members
viewerRead-only access to files

Subcommands

members list <share_id>

List all members of a share.

$ hand members list abc123
ID                    EMAIL                     ROLE      NAME
--------------------------------------------------------------------------------
member-001...         owner@example.com         owner     John Doe
member-002...         editor@example.com        editor    Jane Smith
member-003...         viewer@example.com        viewer    Bob Wilson

members add <share_id> <email>

Add a new member to a share.

OptionDescriptionDefault
--role <ROLE>Member role: editor or viewerviewer
--name <NAME>Display name for the memberEmail prefix
$ hand members add abc123 colleague@example.com
Member added: member-004...

$ hand members add abc123 editor@example.com --role editor
Member added with editor role

$ hand members add abc123 friend@example.com --role viewer --name "My Friend"
Member added: member-005...

members update <share_id> <member_id>

Update a member's role.

$ hand members update abc123 member-002 --role viewer
Member updated

$ hand members update abc123 member-003 --role editor
Member updated

members remove <share_id> <member_id>

Remove a member from a share.

$ hand members remove abc123 member-003
Member removed

Examples

Share with a colleague

# Create a share
hand shares create "Project Files" ~/project

# Add colleague as editor
hand members add <share_id> colleague@example.com --role editor

# Verify they were added
hand members list <share_id>

Downgrade access

# List current members
hand members list <share_id>

# Change editor to viewer
hand members update <share_id> <member_id> --role viewer

Notes

  • Only the share owner can add or remove members
  • The user must exist in Handrive (use hand users invite for new users)
  • You cannot remove yourself or change the owner role

See Also