npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2025 – Pkg Stats / Ryan Hefner

kaput-cli

v1.1.1

Published

CLI tools for Put.io

Readme

Logo

Kaput-CLI

CLI tools for Put.io

oclif Version Downloads/week License

Usage

$ npm install -g kaput-cli
$ kaput COMMAND
running command...
$ kaput (-v|--version|version)
kaput-cli/1.1.1 linux-x64 node-v12.16.3
$ kaput --help [COMMAND]
USAGE
  $ kaput COMMAND
...

Commands

kaput debug

Output the current config

USAGE
  $ kaput debug

DESCRIPTION
  ...
  This will output the path and current state of the config file used by Kaput-CLI.
  Warning: This will include your auth tokens.

See code: src/commands/debug.js

kaput download FILEID

Downloads a file from Put.io

USAGE
  $ kaput download FILEID

ARGUMENTS
  FILEID  ID of the file to download.

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Downloads a file from Put to your local storage.
  If a folder ID is given, a zip is created and that is downloaded instead.
  Note: The ID can be found in the URL of the file from Put.io

See code: src/commands/download.js

kaput files [FOLDERID]

Manage your Put.io files

USAGE
  $ kaput files [FOLDERID]

ARGUMENTS
  FOLDERID  ID of folder to display files in.

OPTIONS
  --all                      All files of the user will be returned.
  --contentType=contentType  Query Put for the specified content type.
  --fileType=fileType        Query Put for the specified file type.
  --json                     Output data as pure JSON instead of in a table.

  --limit=limit              Number of items to return, if -1 is used, all files will be retreived recursively. Default
                             is 1000.

  --profile=profile          Name of the profile to use for authentication. Defaults to the "default" profile.

  --sort=sort                Property to sort by. Properties available: NAME_ASC, NAME_DESC, SIZE_ASC, SIZE_DESC,
                             DATE_ASC, DATE_DESC, MODIFIED_ASC, MODIFIED_DESC.

DESCRIPTION
  ...
  This command lists all of the files in your root folder by default.

See code: src/commands/files/index.js

kaput files:delete FILEID

Delete a file

USAGE
  $ kaput files:delete FILEID

ARGUMENTS
  FILEID  ID of the file to delete.

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  This will delete a file or folder from your account.
  Note: If you don't have the trash enabled on your account, this data will be unrecoverable.

See code: src/commands/files/delete.js

kaput files:link FILEID

Generate a download link

USAGE
  $ kaput files:link FILEID

ARGUMENTS
  FILEID  ID of the file to generate a link for.

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  This command generates a fresh download link.
  Note: This link will only work on the device it was generated on.

See code: src/commands/files/link.js

kaput files:mkdir FOLDERNAME

Create new folder

USAGE
  $ kaput files:mkdir FOLDERNAME

ARGUMENTS
  FOLDERNAME  Name of the new folder.

OPTIONS
  -p, --parentID=parentID  ID of the folder to create the new folder in. Defaults to root.
  --profile=profile        Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Creates a new folder with the given name at the specified folder.

See code: src/commands/files/mkdir.js

kaput files:search QUERY

Search for a file

USAGE
  $ kaput files:search QUERY

ARGUMENTS
  QUERY  Name of item to search for.

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  This command allows you search your entire account for a file.

See code: src/commands/files/search.js

kaput help [COMMAND]

display help for kaput

USAGE
  $ kaput help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

kaput login

Login to Put.io

USAGE
  $ kaput login

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Authenticates the CLI with your Put.io account.

  Providing a name to the profile flag allows you to save multiple accounts to Kaput for later use.

  The environment variables PUTIO_PROFILE and PUTIO_TOKEN are also available so that you can switch accounts quickly and 
  without having the token stored locally in a file.
  Setting the environment variable PUTIO_PROFILE tells Kaput which saved profile to use.
  Setting the environment variable PUTIO_TOKEN directly gives Kaput a Put auth token to use.
  These variables do not neeed to be used together. It is recommended to set one or the other.
  Note: This stores the access token locally.

See code: src/commands/login.js

kaput logout

Logout from Put

USAGE
  $ kaput logout

OPTIONS
  --profile=profile  Name of the profile to remove. Defaults to the "default" profile.

DESCRIPTION
  ...
  Removes your account from the CLI.

See code: src/commands/logout.js

kaput search KEYWORD

Search top indexers with chill

USAGE
  $ kaput search KEYWORD

ARGUMENTS
  KEYWORD  Name of the content to search for.

OPTIONS
  -f, --folderID=folderID  ID of the folder it should download to on Put. Defaults to the root folder.
  -i, --indexer=indexer    ID of the indexer to search exclusively.
  -n, --nastyResults       If passed, chill.institute will not filter out nasty results.
  --profile=profile        Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Indexer searching is kindly provided by https://chill.institute/
  This command allows you to search top trackers to add files to your Put account.

See code: src/commands/search/index.js

kaput search:indexers

List indexers

USAGE
  $ kaput search:indexers

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Outputs a list of all available indexers that are usable for searching.

See code: src/commands/search/indexers.js

kaput search:top

Get top movies from The Pirate Bay.

USAGE
  $ kaput search:top

OPTIONS
  -f, --folderID=folderID  ID of the folder it should download to on Put. Defaults to the root folder.
  --profile=profile        Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Returns the top movies from The Pirate Bay.

See code: src/commands/search/top.js

kaput transfers

Manage your Put.io transfers

USAGE
  $ kaput transfers

OPTIONS
  --json             Output data as pure JSON instead of in a table.
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Lists current transfers on the account.

See code: src/commands/transfers/index.js

kaput transfers:add URL

Add a transfer to Put.io

USAGE
  $ kaput transfers:add URL

ARGUMENTS
  URL  URL of the file to download.

OPTIONS
  -f, --folderID=folderID  Folder ID to download into. Defaults to root.
  --profile=profile        Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Takes a URL or Magnet as an argument and sends it to Put to download.

See code: src/commands/transfers/add.js

kaput transfers:cancel TRANSFERID

Cancel a transfer

USAGE
  $ kaput transfers:cancel TRANSFERID

ARGUMENTS
  TRANSFERID  ID of the transfer to cancel.

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  If transfer is in seeding state, stops seeding. Else, removes transfer entry. Does not remove their files.

See code: src/commands/transfers/cancel.js

kaput transfers:clear

Clear transfer list

USAGE
  $ kaput transfers:clear

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  This command clears all completed items from the tranfers list.
  Note: No data will be removed.

See code: src/commands/transfers/clear.js

kaput transfers:retry TRANSFERID

Retry a failed transfer

USAGE
  $ kaput transfers:retry TRANSFERID

ARGUMENTS
  TRANSFERID  ID of the transfer to retry.

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Tells Put.io to try a transfer again.

See code: src/commands/transfers/retry.js

kaput whoami

Display your username

USAGE
  $ kaput whoami

OPTIONS
  --profile=profile  Name of the profile to use for authentication. Defaults to the "default" profile.

DESCRIPTION
  ...
  Checks Put.io for the username of the account currently authenticated with the CLI.

See code: src/commands/whoami.js