Ways in

Command line

The drop command uploads files and prints their links. It works in terminals, scripts and CI, and for AI agents with shell access.

Install

$ npm install -g drop-media
$ drop login YOUR_API_KEY

It needs Node 18.3 or newer and has no dependencies. drop login saves the key to ~/.config/drop/config.json, readable only by you. In CI, set DROP_API_KEY instead.

Upload

$ drop screenshot.png                     # prints the link
$ drop *.png -m                            # markdown snippets for a PR
$ drop report.pdf --private --expires 7d   # signed link, deleted after a week
$ pbpaste | drop - --filename clipboard.png  # from stdin

Find and manage files

$ drop ls dashboard            # search your library
$ drop link FILE_ID --ttl 1d   # a fresh link for a private file
$ drop rm FILE_ID              # delete
$ drop me                      # account, limits and the key's abilities

Options

-p, --privateflag Only reachable through expiring signed links.
-e, --expiresduration Delete automatically after e.g. 30m, 1h, 7d, 2w.
-n, --namestring Use this name in the link instead of a random id (one file at a time).
--filenamestring The file name to use when reading from stdin.
-m, --markdownflag Print a markdown snippet instead of the link.
--jsonflag Print the full JSON response.
--ttlduration For drop link: how long a private link works (default 1h, at most 7d).

Run drop --help for everything. DROP_URL points it at another server.

Connect agents

drop mcp prints the commands to connect Claude Code and other MCP clients using your saved key.