put.io (kaput CLI)

Manage a put.io account via the kaput CLI (transfers, files, search) — hoist the mainsail, add magnets/URLs, and check transfer status; best paired with the chill-institute skill.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install putio

put.io (kaput CLI)

This skill uses the unofficial kaput CLI to operate put.io from the command line.

If you also have the chill-institute skill installed, you can:

use chill.institute to start a transfer (“send to put.io”), then
use this skill to verify and monitor that the cargo is actually arriving.

Install

Requires Rust + Cargo.
Install:
```
cargo install kaput-cli
```
Ensure kaput is on your PATH (typically ~/.cargo/bin).

Authenticate (device-code flow)

Run:
```
kaput login
```
It prints a link + short code (e.g. https://put.io/link + ABC123).
User enters the code in the browser.
The CLI completes and stores a token locally.

Check auth:

bash skills/putio/scripts/check_auth.sh

Common actions (scripts)

All scripts auto-locate kaput (supports KAPUT_BIN=/path/to/kaput).

List transfers:

bash skills/putio/scripts/list_transfers.sh

Add a transfer (magnet / torrent URL / direct URL):

bash skills/putio/scripts/add_transfer.sh "magnet:?xt=urn:btih:..."

Search files:

bash skills/putio/scripts/search_files.sh "query"

Status (transfers; optionally account):

bash skills/putio/scripts/status.sh
SHOW_ACCOUNT=1 bash skills/putio/scripts/status.sh

Raw CLI

For advanced actions:

kaput --help
kaput transfers --help
kaput files --help

Security notes

Do not paste passwords into chat. Use kaput login device-code flow.
kaput stores credentials locally (token file). Treat it as sensitive and avoid sharing it.
Avoid running kaput debug in shared logs/screenshots (may reveal local config details).