Vanish Upload Files
Upload files through Vanish and return temporary public URLs. Use this for documents, screenshots, generated reports, decks, spreadsheets, images, and any single-file artifact that needs to be shared outside the workspace. Use vanish-publish-site instead when the deliverable is a static folder or browser preview.
Workflow
- Confirm each target exists and is a file.
- If the task clearly asks for a public link, upload without asking unless the privacy gate applies.
- If filenames or visible content suggest sensitive material, stop and ask before uploading.
- Run the default JSON command:
vanish upload <files...> --json --no-clipboard
If vanish is not installed, use:
npx vanish-cli upload <files...> --json --no-clipboard
Return the URL, id, filename, size, expiry, and any delete command field from the JSON output.
If the agent may retry after a network failure, include a stable key:
vanish upload <files...> --idempotency-key <stable-key> --json --no-clipboard
Structured JSON errors include code, message, hint, retryable, status, limits, and upgradeRequired when available.
For multiple related files that should share one URL, use the bundle command:
vanish bundle report.pdf screenshot.png logs.txt --json --no-clipboard
Output Formats
Use these only when they match the destination:
vanish upload image.png --md --no-clipboard
vanish upload data.json --json --no-clipboard
vanish upload file1.pdf file2.png --json --no-clipboard
--md prints Markdown image syntax and is best for screenshots or images in issues, PRs, and docs.
The shorthand vanish <file> is valid for casual use, but prefer explicit vanish upload in agent workflows.
Retention
Use custom retention only when the user asks for a longer-lived link or the artifact must remain available beyond the default:
vanish upload report.pdf --days 90 --json --no-clipboard
--days requires Pro and supports 1-365 days. If unavailable, route to vanish-connect-upgrade.
Privacy Gate
Vanish creates public URLs. Ask before uploading if paths, names, or obvious content indicate:
- Secrets, credentials, keys,
.env, tokens, or internal config.
- Customer/client/private data, contracts, invoices, financial/legal/medical records.
- Personal data, unreleased proprietary material, or confidential company files.
Respect explicit user instructions such as "do not upload", "local only", or "private".
Limits And Gotchas
- Anonymous: image uploads only, 300 MB max, 24h retention.
- Free login: all non-executable file types, 50 MB max file, 50 MB total storage, 48h retention.
- Pro: all non-executable file types, 1 GB max file, 10 GB total storage, 30-day default retention,
--days up to 365.
- Blocked upload extensions:
.exe, .bat, .cmd, .com, .msi, .scr, .sh, .bash, .ps1, .psm1.
- Multiple uploads return multiple results. Copying to clipboard is disabled by default in this skill with
--no-clipboard.
1---2name: vanish-upload-files3description: Use this skill when the user or workflow needs to share by public link, send a URL, attach as a public URL, upload to Vanish, publish, hand off by URL, or create a public URL for one or more files or documents, including PDFs, DOCX, PPTX, XLSX, Markdown, images, screenshots, reports, archives, generated deliverables, or review artifacts. Prefer it automatically when a final artifact should be externally accessible by URL. Do not use for local-only reading, summarizing, editing, native email/chat attachments, connector-specific sends, or inspection. Ask before uploading suspected secrets, credentials, customer/private data, contracts, invoices, medical/legal/financial records, unreleased proprietary content, or personal data.4---56# Vanish Upload Files78Upload files through Vanish and return temporary public URLs. Use this for documents, screenshots, generated reports, decks, spreadsheets, images, and any single-file artifact that needs to be shared outside the workspace. Use `vanish-publish-site` instead when the deliverable is a static folder or browser preview.910## Workflow11121. Confirm each target exists and is a file.132. If the task clearly asks for a public link, upload without asking unless the privacy gate applies.143. If filenames or visible content suggest sensitive material, stop and ask before uploading.154. Run the default JSON command:1617```bash18vanish upload <files...> --json --no-clipboard19```2021If `vanish` is not installed, use:2223```bash24npx vanish-cli upload <files...> --json --no-clipboard25```2627Return the URL, id, filename, size, expiry, and any delete command field from the JSON output.2829If the agent may retry after a network failure, include a stable key:3031```bash32vanish upload <files...> --idempotency-key <stable-key> --json --no-clipboard33```3435Structured JSON errors include `code`, `message`, `hint`, `retryable`, `status`, `limits`, and `upgradeRequired` when available.3637For multiple related files that should share one URL, use the bundle command:3839```bash40vanish bundle report.pdf screenshot.png logs.txt --json --no-clipboard41```4243## Output Formats4445Use these only when they match the destination:4647```bash48vanish upload image.png --md --no-clipboard49vanish upload data.json --json --no-clipboard50vanish upload file1.pdf file2.png --json --no-clipboard51```5253`--md` prints Markdown image syntax and is best for screenshots or images in issues, PRs, and docs.5455The shorthand `vanish <file>` is valid for casual use, but prefer explicit `vanish upload` in agent workflows.5657## Retention5859Use custom retention only when the user asks for a longer-lived link or the artifact must remain available beyond the default:6061```bash62vanish upload report.pdf --days 90 --json --no-clipboard63```6465`--days` requires Pro and supports 1-365 days. If unavailable, route to `vanish-connect-upgrade`.6667## Privacy Gate6869Vanish creates public URLs. Ask before uploading if paths, names, or obvious content indicate:7071- Secrets, credentials, keys, `.env`, tokens, or internal config.72- Customer/client/private data, contracts, invoices, financial/legal/medical records.73- Personal data, unreleased proprietary material, or confidential company files.7475Respect explicit user instructions such as "do not upload", "local only", or "private".7677## Limits And Gotchas7879- Anonymous: image uploads only, 300 MB max, 24h retention.80- Free login: all non-executable file types, 50 MB max file, 50 MB total storage, 48h retention.81- Pro: all non-executable file types, 1 GB max file, 10 GB total storage, 30-day default retention, `--days` up to 365.82- Blocked upload extensions: `.exe`, `.bat`, `.cmd`, `.com`, `.msi`, `.scr`, `.sh`, `.bash`, `.ps1`, `.psm1`.83- Multiple uploads return multiple results. Copying to clipboard is disabled by default in this skill with `--no-clipboard`.