From file to controlled link.

Use the macOS shortcut, web uploader, or HTTP API. Each follows the same direct-upload lifecycle.

macOS app

The Mac app currently ships from source while the signed Homebrew release is being prepared. Build it locally, point it at your Wirecopy account, then use Control–Option–C after copying a Finder file or image.

git clone https://github.com/wirecopy/service.git
cd clipboard-to-link/client/macos
swift build
swift run WirecopyApp

In Wirecopy, open Settings, enter the service URL and a token from Devices, then grant Accessibility access when macOS asks.

Web app

Open Wirecopy, choose a file (or drop one from Finder), and press Transmit file. The browser reads the file only after your explicit selection. Clipboard access also requires a user gesture.

HTTP API

POST /api/v1/upload_intents
Authorization: Bearer wc_live_…
Content-Type: application/json

{"upload":{"filename":"report.pdf","content_type":"application/pdf","byte_size":482091}}

PUT the exact bytes to the returned upload.url, including its returned headers. Then call POST /api/v1/upload_intents/:id/complete.

Lifecycle

Terminal alternatives are rejected, expired, revoked, and deleted.

Local stack

docker compose up -d postgres minio
mise x -- bin/setup
mise x -- bin/dev

No Clerk, Dodo, R2, or malware-scanner credentials are needed locally.