GitHub - upfilesh/cli: CLI for upfile.sh — instant file uploads from the terminal

Upload any file from your terminal. Get a permanent URL instantly.

Install

Setup

Self-signup (get an API key)

upfile signup --email your@email.com

This creates an account and saves your API key to ~/.upfile/config.json.

Existing API key

upfile config set api-key YOUR_API_KEY

Usage

# Check storage status
upfile status

# Public — permanent URL, anyone can access
upfile screenshot.png
# https://cdn.upfile.sh/xK9mZ.png

# Expiring — self-destructs after TTL (seconds)
upfile report.pdf --expiry 3600

# Private — auth-gated, only you can access
upfile secret.pdf --private

# JSON output — for AI agents and scripts
upfile screenshot.png --json

# Pipe from stdin — capture and upload in one line
screencapture -x - | upfile
cat file.txt | upfile --json

Upgrade

When you hit the 1GB storage limit, upgrade to Pro:

You'll receive an email with a checkout link.

Options

Flag	Description
`--private`	Private file, requires auth to access
`--expiry <sec>`	Expiring URL with TTL in seconds
`--json`	Full JSON response (url, id, visibility, expires_at)
`-v`, `--version`	Print CLI version

JSON response

{
  "id": "xK9mZaBcDe",
  "url": "https://cdn.upfile.sh/xK9mZaBcDe.png",
  "visibility": "public",
  "size": 84231,
  "type": "image/png",
  "expires_at": null,
  "created_at": "2026-03-02T03:00:00.000Z"
}

Config

upfile config set api-key <key>      # save API key
upfile config set endpoint <url>     # self-hosted endpoint
upfile config get                    # view current config

Config stored at ~/.upfile/config.json.

Environment variables

Var	Description
`UPFILE_API_KEY`	API key (overrides config file)

Self-hosting

Deploy your own upfile instance on Cloudflare Workers:

github.com/upfilesh/worker