xdrop

Original：🇺🇸 English

Translated

2 scripts

Use this skill when the user wants to send or fetch files through an Xdrop server from the terminal, asks to automate encrypted Xdrop share-link workflows, provides an Xdrop `/t/:transferId#k=...` link to download and decrypt locally, or needs Xdrop CLI flags such as `--quiet`, `--json`, `--expires-in`, `--output`, or `--api-url`, even if they do not explicitly mention the skill name.

78installs

Sourcexixu-me/xdrop

Added on2026-03-22

NPX Install

npx skill4agent add xixu-me/xdrop xdrop

SKILL.md Content

View Translation Comparison →

Xdrop

Use the bundled scripts inside this skill directory.

Available scripts

```
scripts/upload.mjs
```
— Upload local files or directories to an Xdrop server and print the share link
```
scripts/download.mjs
```
— Download an Xdrop share link, decrypt it locally, and save the files

Environment requirements:

Bun
Local filesystem access
Network access to the target Xdrop server

Upload

bash

bun scripts/upload.mjs --server <xdrop-site-url> <file-or-directory> [...]

Prefer these flags when relevant:

```
--quiet
```
: suppress progress output and keep stdout clean
```
--json
```
: return
```
transferId
```
,
```
shareUrl
```
, and
```
expiresAt
```
```
--expires-in <seconds>
```
: choose a supported expiry
```
--api-url <url>
```
: override the default
```
<server>/api/v1
```
```
--name <value>
```
: set the transfer display name
```
--concurrency <n>
```
: limit parallel uploads per file

Useful examples:

bash

bun scripts/upload.mjs --server http://localhost:8080 ./dist/report.pdf
bun scripts/upload.mjs --server http://localhost:8080 --quiet ./archive.zip
bun scripts/upload.mjs --server http://localhost:8080 --expires-in 600 --json ./notes.txt

If the user wants verification, upload a small temporary file and then confirm the public transfer API or browser can open the returned link.

Download

Require the full share link, including

#k=...

. Without the fragment key, the transfer cannot be decrypted.

bash

bun scripts/download.mjs "<share-url>"

Prefer these flags when relevant:

```
--output <dir>
```
: choose the destination directory
```
--quiet
```
: suppress progress output and keep stdout clean
```
--json
```
: return
```
transferId
```
,
```
outputRoot
```
, and saved file paths
```
--api-url <url>
```
: override the default
```
<share-origin>/api/v1
```

Useful examples:

bash

bun scripts/download.mjs "http://localhost:8080/t/abc123#k=..."
bun scripts/download.mjs --output ./downloads "http://localhost:8080/t/abc123#k=..."
bun scripts/download.mjs --quiet --json --output ./downloads "http://localhost:8080/t/abc123#k=..."

By default the downloader writes to

./xdrop-<transferId>

and preserves the manifest's relative paths.

Gotchas

A download link without the
```
#k=...
```
fragment is not decryptable. Ask for the full original share URL.
Use
```
--quiet
```
whenever another command or caller needs to capture stdout. Progress logs otherwise go to stderr, but the final result still matters.

Guardrails

Prefer
```
--quiet
```
when another command or script needs to capture stdout.
Keep the full share link fragment intact for downloads.
Do not bypass the scripts' built-in path sanitization or transfer cleanup behavior with manual ad hoc commands unless the user explicitly asks.

xdrop

NPX Install

Tags

SKILL.md Content

Xdrop

Available scripts

Upload

Download

Gotchas

Guardrails