name: putio
description: 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.

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)

1. Run:

   kaput login

1. It prints a link + short code (e.g. https://put.io/link + ABC123).
2. User enters the code in the browser.
3. 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).