swiftclip

SwiftClip Developer CLI

The SwiftClip Developer CLI is the official terminal companion for SwiftClip, the hyper-fast, secure, and account-free clipboard designed for moving text and files instantly.

This CLI gives Premium developers the ability to bypass the browser entirely and upload application logs, deployment tokens, database dumps, and environment variables securely straight from their server terminal.

Key Features

• ⚡️ Instant Generation: Upload multiple files (up to 20 per transfer) or strings directly from the command line and receive a 4-digit fetch code instantly.
• 🛡️ End-to-End Encryption: By passing a password flag, the CLI natively chunks and mathematically encrypts your files directly on your computing hardware before they ever touch the network mapping back to the browser.
• 🔥 True Burn After Reading: Securely configure payloads to be permanently wiped from the Cloudflare R2 bucket and KV storage immediately upon first access. Session metadata is destroyed the exact millisecond the code is entered.

Getting Started

You do not need to globally install the package. You can run it instantly using npx.

1. Authenticate

To use the CLI, you must be a SwiftClip Premium member. Navigate to your SwiftClip Dashboard, click API Key in the header, and copy your private sc_live_xxx token.

Authenticate your terminal session securely:

npx swiftclip login <YOUR_API_KEY>

(Your credential will be saved securely to ~/.swiftclip.json on your local machine).

2. Send Data

You can pass a raw string of text directly into the send command. Wrap it in quotes if it contains spaces.

npx swiftclip send "Here is my secret webhook URL"

3. Send Files

You can pass one or more absolute or relative paths to any local files (up to 20 files per transfer, 10MB maximum total size).

npx swiftclip send ./production-logs.txt ./database.dump

Security Flags

The CLI matches the browser's exact military-grade security capabilities. You can append these flags to any send command:

--burn

Immediately and permanently deletes the text/file from global storage the exact second the receiver accesses it.

npx swiftclip send ./database.dump --burn

--password <secret>

Invokes crypto-js to locally intercept your file buffer, cast it as a base64 string, and encrypt it using AES architecture with your provided password. The server has fundamentally zero-knowledge of the payload.

npx swiftclip send "Super secret string" --password mysecurepassword123

(You can also use both flags simultaneously).

Receiving

Every successful command will instantly return a 4-digit code in your terminal:

🎉 Success! Your secure code is: 1234
🌐 Open https://swiftclip.io/c/1234 to fetch it.

You can walk over to any browser, navigate to the URL, or simply punch the code into the SwiftClip homepage to decrypt and download your payload.

Happy shipping! 🚀