file-kiwi-upload

Uploads explicitly selected local files to file.kiwi with end-to-end encryption and returns a share link.

4|Updated Jun 2, 2026
One-click install
npx skills add https://github.com/sukbearai/king-ai --skill file-kiwi-upload-sukbearai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: file-kiwi-upload
Source: https://github.com/sukbearai/king-ai/tree/main/packages/skills/skills/file-kiwi-upload
Command: npx skills add https://github.com/sukbearai/king-ai --skill file-kiwi-upload-sukbearai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @file-kiwi/node, and includes scripts (resource) components.

What problem does it solve? Transferring local files through an external service requires careful handling of privacy, authorization, and interrupted transfers. This Skill uploads only files the user has explicitly named to file.kiwi using its official end-to-end encrypted Node client, with a mandatory confirmation gate before any data leaves the machine. ## Core Features & Use Cases - Gated External Upload: Runs a dry-run preflight showing resolved paths, sizes, and destination, then requires explicit user confirmation before transmitting any file data. - Encrypted Transfer via Official Client: Uses the pinned @file-kiwi/node@1.0.9 package against the official https://api.file.kiwi endpoint, uploading one encrypted chunk at a time. - Resumable Uploads: Interrupted uploads leave private state under ~/.king-ai/file-kiwi-upload that can be resumed by folder ID after re-confirmation. - Use Case: A user needs to send three large project archives to a colleague. The Skill validates the files, discloses the transfer details, uploads them after confirmation, and returns a share URL whose fragment holds the decryption key. ## Quick Start Ask the assistant to upload specific named files to file.kiwi, for example: upload /home/user/report.pdf and /home/user/data.zip to file.kiwi and give me the share link.

Frequently Asked Questions about file-kiwi-upload

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upload local files to file.kiwi from the command line?▼

Run the upload script with the absolute file paths after a dry-run preflight, then pass --confirm-external-upload once you have explicitly confirmed the transfer. The script invokes the official @file-kiwi/node client and prints the share URL on success.

How do I resume an interrupted file.kiwi upload?▼

Resume by passing --confirm-external-upload --resume <folder-id> to the upload script. The state file filekiwi.tmp.<folder-id>.json must exist in the private state directory, and you should obtain explicit permission before resuming the external transfer.

What file limits does the file.kiwi public API enforce?▼

The wrapper accepts 1 to 10 regular readable files per upload. Empty files are rejected, and each file must be at or below the documented 999 GiB public API limit.

Is the file.kiwi share link safe to share in logs or commits?▼

No. The URL fragment contains the decryption key, so anyone with the full link can access the files. Treat it as a secret capability URL and never paste it into public logs, issues, commits, or pull requests.

Why does the upload script reject directories or globs?▼

The Skill only uploads files the user has explicitly named and confirmed. It rejects directories, unresolved globs, and recursive scans to prevent unintended data from being transmitted to an external service.