qshare
Share one local file through a public download URL or QR code using CNB uploads by default, with 3-day retention and immediate manual deletion, or an optional TryCloudflare tunnel.
qshare
Use this skill when the user asks to make one local file available through a public
download URL or QR code. qshare uploads to a CNB Release by default. Files kept in
CNB are stored for 3 days by default, and the current upload can be manually deleted
immediately at the post-upload prompt. Only the CNB channel supports deleting
uploaded files. Add --cf when the user chooses to serve the file from their own
machine through a temporary TryCloudflare tunnel.
Default channel: CNB
-
Resolve the exact local file path. If the user has not identified one file, ask for the path instead of sharing a directory or guessing a filename.
-
Explain that the file will be uploaded to CNB, that kept uploads have a default 3-day retention, and that the resulting public URL has no access control. Recommend encrypting private or sensitive files before sharing them. Honor existing authorization to share this file; clarify the channel if the user requires sharing without remote storage.
-
Run qshare with the path quoted so spaces and shell metacharacters are safe:
bash qshare "/path/to/file.zip"--cnbexplicitly selects the same default channel. The upload starts immediately without a pre-upload confirmation.--ttland--portapply only to--cf; they do not change CNB retention. -
Handle the post-upload deletion prompt according to the user's intent:
- To leave a working download link, answer
nto keep the file. CNB stores kept files for 3 days by default; qshare and the local machine can stop after upload without ending the download link. - The user can manually delete this upload immediately by pressing Enter or
answering
y. Enter is the default delete answer, not a keep answer. Leave the prompt open while the recipient downloads if the user wants to delete the file as soon as the transfer finishes. Confirm deletion only when requested or authorized; do not pipe a blank answer automatically. - Deletion affects the CNB copy, never the local source file. After successful deletion, the download URL and QR code are invalid, and Windows skips the browser QR question. Do not return a deleted upload's URL as a working link.
- To leave a working download link, answer
-
Report the line labelled
PUBLIC FILE URLexactly as printed for a kept upload, along with the default 3-day retention. A QR renderer failure does not invalidate a successfully printed URL. Check deletion errors before claiming the remote file was removed; a successful process exit alone does not prove deletion.
Do not expose arbitrary local paths, directory listings, or additional files. Do not promise permanent CNB storage or access control.
Optional channel: TryCloudflare
Use --cf when the user chooses a tunnel, including requests to share without
storing the file in CNB:
qshare "/path/to/file.zip" --cf
qshare "/path/to/file.zip" --cf --ttl 30m
The file is served from the local machine. The tunnel's default lifetime is
2 hours; --ttl accepts 30m, 90s, 2h, or a positive number of seconds.
Use --port PORT only when a fixed local port is needed. Report PUBLIC FILE URL
exactly as printed. The URL stops working when the TTL expires or the tunnel is
stopped. Keep the serving process running while the recipient needs access.
The --cf channel has no CNB upload or remote-file deletion action; stop the
tunnel to end sharing. The local source file stays intact. Do not describe CNB's
3-day retention or deletion prompt as applying to --cf, and do not claim that a
TryCloudflare share is persistent or access-controlled.
Operational notes
- On Unix-like systems
--cfmay offer to detach into the background. Only choose that mode when the user asks for background operation; Windows remains in the foreground. - On Windows, a kept CNB upload or an active
--cfshare offers a browser QR page after the other prompts (open by default); answer according to the user's preference. A deleted CNB upload must not open a QR page for an invalid link. --cfinstalls or uses a matchingcloudflaredbinary as documented by the package. Do not download an unrelated binary or weaken TryCloudflare URL validation to work around an error.- If qshare reports an error, show the actionable error text and do not invent a URL. Never print credentials or tokens from the runtime environment.
Related skills
- Downloads
- 376All time
- Security audit
- Review
- Last updated
- 1mo ago
- Current version
- v0.1.1
- License
- MIT-0
