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.

Pasang
$clawhub 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: bash cargo install kaput-cli

  • Ensure kaput is on your PATH (typically ~/.cargo/bin).

Authenticate (device-code flow)

  1. Run: bash kaput login

  2. It prints a link + short code (e.g. https://put.io/link + ABC123).

  3. User enters the code in the browser.

  4. 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 bash skills/putio/scripts/list_transfers.sh

  • Add a transfer (magnet / torrent URL / direct URL): bash bash skills/putio/scripts/add_transfer.sh "magnet:?xt=urn:btih:..."

  • Search files: bash bash skills/putio/scripts/search_files.sh "query"

  • Status (transfers; optionally account): bash 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).