Merkleshare CLI

Upload, manage, and share files directly from your terminal.

Quick Install

macOS / Linux

curl -fsSL https://www.merkleshare.com/install.sh | bash

Getting Started

1

Authenticate

ms login

Opens your browser to sign in and link the CLI to your account.

2

Create a collection with files

ms create my-project ./document.pdf ./image.png

Add --public to make it visible on your profile.

3

Share

ms share my-project

Generates a shareable link to your collection.

Commands

ms login

Authenticate with your Merkleshare account. Opens your browser to complete sign-in.

$ ms login
ms logout

Sign out and clear stored credentials.

$ ms logout
ms whoami

Display your current authentication status and profile.

$ ms whoami
ms ls

List your collections.

$ ms ls
ms ls @<handle>

List another user's public collections.

$ ms ls @alice.bsky.social
ms ls <collection>

List files in a specific collection.

$ ms ls my-collection
ms create <name> [files...]

Create a new collection, optionally with files. Use --public or --unlisted to set visibility.

$ ms create "Photos" ./photo1.jpg ./photo2.png --public
ms add <collection> <files...>

Add files to an existing collection.

$ ms add my-collection ./file1.pdf ./file2.png
ms download <collection>

Download all files from a collection. Use -o to specify output directory.

$ ms download my-collection -o ./downloads
ms share <collection>

Get a shareable link for a collection.

$ ms share my-collection
ms sia <collection> <file>

Get a portable Sia URL for a file that works with other Sia-compatible apps.

$ ms sia my-collection document.pdf
ms search <query>

Search collections and files.

$ ms search "project notes"
ms feed

View the public feed of recent collections.

$ ms feed
ms update

Check for updates and install the latest version.

$ ms update