| name | ffl |
| description | FastFileLink (ffl) assistant — detect environment, install ffl if needed, and help the user share files, download files, configure tunnels, set up E2EE/auth, and automate file-sharing workflows. Invoke whenever the user wants to share a file or folder, get a download link, receive a file from someone, protect a transfer with a password or encryption, limit downloads to one use, or do anything ffl/FastFileLink-related — even if they don't say "ffl" explicitly. Also trigger for phrases like "send this file", "give me a shareable link", "share these files securely", "someone needs to download X from me", "get me a one-time link", or "upload and share". |
You are an expert on ffl (FastFileLink). Always give the user the exact command first, then handle execution.
Step 1: Detect environment
Check your tool list for fflShareFile, fflDownload, etc. — if present, use them directly and skip the script.
Otherwise, run:
bash <SKILL_DIR>/scripts/detect_env.sh
| ADVICE | Action |
|---|
run_cli | Run ffl commands in the shell |
install_then_run | Install ffl (see below), then run |
give_command_sandbox | Give the exact command + read and show references/ffl_mcp_setup.md |
Install ffl (ADVICE=install_then_run)
Linux / macOS: curl -fsSL https://fastfilelink.com/install.sh | bash
Windows: iwr -useb https://fastfilelink.com/install.ps1 | iex
Portable (all platforms):
curl -fL https://github.com/nuwainfo/ffl/releases/latest/download/ffl.com -o ffl.com
chmod +x ffl.com && mv ffl.com ~/.local/bin/ffl
Command reference
Sharing
ffl file.pdf
ffl a.pdf b.jpg c.txt
ffl myfolder/
cat data.csv | ffl -
ffl @filelist.txt
--name / -n NAME custom filename for recipient
--exclude PATTERNS '*.log,__pycache__' or 're:\.env$'
--upload [DURATION] server upload: "1 day", "6 hours" — file stays available without keeping computer on (registered + costs points)
--resume resume interrupted upload
--max-downloads N expire after N downloads (P2P)
--timeout SECONDS expire after N idle seconds (P2P)
--e2ee end-to-end encryption (AES-256-GCM)
--auth-user / --auth-password HTTP Basic Auth
--recipient-auth MODE pickup | pubkey | pubkey+pickup | email
--pickup-code CODE specific pickup code
--recipient-public-key FILE .fflpub for pubkey auth
--alias ALIAS custom reusable link alias (registered + costs points)
--receipt [EMAIL] email when recipient downloads (registered + costs points)
--receipt-confirm [MSG] require recipient confirmation first
--force-relay disable direct WebRTC
--preferred-tunnel TUNNEL save tunnel pref (cloudflare/ngrok/bore)
--qr [FILE] QR code in terminal or saved image
--json FILE output link+metadata to JSON (CI/CD)
Downloading
ffl https://ffl.link/xxxx
ffl https://ffl.link/xxxx -o ~/Downloads/
ffl https://ffl.link/xxxx --resume
ffl https://ffl.link/xxxx --recipient-auth pickup --pickup-code 482910
ffl https://ffl.link/xxxx --recipient-auth pubkey --recipient-private-key alice.fflkey
Account / misc
ffl register / ffl login / ffl status / ffl logout / ffl upgrade / ffl --version
--cli --log-level LEVEL --proxy URL --hook URL
Common scenarios
ffl secret.pdf --max-downloads 1
ffl myfile.zip --upload "2 days"
ffl sensitive.zip --upload "2 days" --e2ee
ffl myfile.zip --e2ee
ffl report.pdf --auth-user alice --auth-password s3cr3t
ffl myfile.zip --recipient-auth pickup
ffl keygen --name alice
ffl myfile.zip --recipient-auth pubkey --recipient-public-key alice.fflpub
ffl myfile.zip --proxy socks5://127.0.0.1:9050 --e2ee --force-relay
ffl build.zip --alias my-project-release
ffl myproject/ --exclude '*.pyc,__pycache__,.git,node_modules'
ffl myfile.zip --json /tmp/out.json
ffl photo.jpg --qr
When the user needs --upload, --alias, or --receipt, note that these require a registered account and cost points — suggest ffl register if they haven't signed up.
