PlugWiki

runpodctl skill (Runpod): manage Runpod pods and endpoints from the terminal

Runpod's own skill that has a coding agent drive the runpodctl CLI to create and manage pods, serverless endpoints, templates and volumes.

Installs
14.8K
on skills.sh
Stars
47
on GitHub
Files
20
besides SKILL.md
Updated
Oct 2026
last repo commit

runpodctl makes your coding agent run the Runpod command line tool to create and manage GPU or CPU pods, serverless endpoints, templates, network volumes and models. It also sends files between your machine and a pod, and fetches SSH details.

It works from a terminal, in CI or scripts, or whenever the Runpod MCP tools are not connected. Everything it creates bills your Runpod account until you stop or delete it, so read each create command before you approve it.

Good for

  • Developers who rent GPU pods or run serverless endpoints on Runpod
  • Teams scripting Runpod in CI or from a terminal
  • Anyone who wants an agent to find a GPU, check price and stock, then deploy

Install runpodctl

Claude Code

  1. 1

    Copy this prompt.

    Install the runpodctl skill in Claude Code. Run this command:
    
    /plugin marketplace add runpod/runpod-plugins-official
    /plugin install runpod@runpod
    /reload-plugins
    
    Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Pick one route, not both. Install the whole set, not only this skill: the runpod skills hand off to each other, and the worked golden-path examples live in the runpod router skill's folder. The plugin also registers the hosted Runpod MCP server, which stays inert until you sign in with /mcp.

From the project README. Source.

What's in the skill

When it loads

Runpod CLI for managing GPU/CPU workloads from the terminal — pods, serverless endpoints, templates, network volumes, Hub deploys, models, SSH, and file transfer (send/receive). Use for terminal/CI/scripting, SSH setup, `doctor`, or when the Runpod MCP tools are not connected; prefer runpod-mcp for structured tool calls in an MCP-enabled session.

Sections in SKILL.md

  1. Install
  2. Quick start
  3. Live Help Is Authoritative
  4. Output & errors
  5. Decision Rules
  6. Serverless facts (context, not rules)
  7. Commands
  8. Pods
  9. Hub
  10. Serverless (alias: sls)
  11. Templates (alias: tpl)
  12. Network Volumes (alias: nv)
  13. Models (Model Repository)
  14. Info & SSH
  15. File Transfer
  16. Utilities

Key facts

Installs on skills.sh
14,791 as of 2026-11-02
Last change to this skill
2026-10-22

What it includes

  • List, create, start, stop, restart, update and delete pods

    Create from a template or a Docker image, GPU or CPU. SKILL.md says to set --min-cuda-version 12.8 on every GPU create and to use --wait instead of a poll loop.

    Try: “Create an A100 pod from the PyTorch template and wait until it is ready.”

    Delete · Pods

  • Create, update, run, check and delete endpoints

    Create from a template or a Hub listing. serverless run submits a job, status and health check it, and logs reads worker output. A worker minimum of 1 bills continuously, even idle.

    Delete · Serverless

  • Find deployable workers and saved pod configs

    hub search finds listings; template search, get, create and delete handle templates. SKILL.md warns that the Hub and pod templates are different catalogs.

    Delete · Hub and templates

  • List, create, update and delete storage volumes

    Volumes are tied to one data center. To delete one, remove the pod that uses it first.

    Delete · Network volumes

  • Upload and manage your own model files

    model add uploads a local model folder to the Runpod Model Repository; model remove deletes it. --model-reference on serverless create caches a Hugging Face model host-side.

    Delete · Models

  • Account, GPU prices and stock, data centers, SSH details

    user shows account info and balance, gpu list shows price and per-data-center stock, and ssh info prints the connection command and key. It does not open a session.

    Runs code · Info and SSH

  • send and receive files with a short-lived code

    send prints a one-time code and waits; receive takes that code. Both ends must exit 0.

    Try: “Send ./data to my pod.”

    Runs code · File transfer

  • doctor, update, version, completion

    doctor sets up the API key and SSH keys interactively. SKILL.md says to run runpodctl update first, because old builds give confusing errors.

    Runs code · Utilities

  • JSON on stdout, coded errors on stderr

    Branch on the code field, such as network_error, rate_limited, not_found or unauthorized. Coded errors need runpodctl 2.8.0 or newer.

    Read · Output and error codes

From the official docs

Permissions

High risk

The agent runs commands that create billable GPU resources and delete pods, endpoints, templates, volumes and models on your Runpod account. Approve each create and delete, and clean up after tests.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Pods and endpoints bill until you stop them

    SKILL.md says a worker minimum of 1 bills continuously even while idle, and a stopped pod still bills for disk and volumes. Delete test resources when done. github.com

  • It can delete pods, endpoints, volumes and models

    runpodctl has delete and remove commands for each resource type. Check the id in each command before you approve it. github.com

  • The CLI install pipes a script into bash

    SKILL.md offers curl -sSL https://cli.runpod.net | bash, or a Homebrew install as the alternative. Prefer Homebrew or read the script first. github.com

  • runpodctl doctor and update change your machine

    doctor writes your API key and sets up SSH keys, and update replaces the binary. SKILL.md tells agents to export RUNPOD_API_KEY instead of running doctor, which is interactive. github.com

  • File transfer exposes a code on screen

    send prints a code that lets the receiving side pull the files. Share it only with the pod or machine you mean. github.com

  • The plugin route installs all 16 skills and the Runpod MCP config

    The marketplace file lists 16 skills for the runpod plugin. It also bundles .mcp.json, which registers the hosted Runpod MCP server at mcp.runpod.io, and a /runpod:migrate command. The git tree shows no hooks file in the plugin folder. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Talks toapi.runpod.io and rest.runpod.io (Runpod APIs). api.runpod.ai (serverless job URLs). cli.runpod.net (CLI install script). *.proxy.runpod.net (pod ports). huggingface.co (model references)
Sign-in and keysRUNPOD_API_KEY from the environment, or the key that runpodctl doctor writes to ~/.runpod/config.toml (per the README).
Scopes
  • Runs runpodctl commands (allowed-tools is Bash(runpodctl:*))

  • Creates, updates and deletes pods, endpoints, templates, network volumes and models

  • Needs RUNPOD_API_KEY or a key saved with runpodctl doctor in ~/.runpod/config.toml

  • Can update the runpodctl binary with runpodctl update

Questions

What does the runpodctl skill do?

It has your coding agent run the Runpod CLI to create and manage pods, serverless endpoints, templates, network volumes and models, check GPU prices and stock, get SSH details and send files.

How do I install runpodctl?

Use the install box at the top of this page. It installs the skills and the runpodctl command line tool, and it needs a Runpod API key from the console under Settings.

Does it need an API key?

Yes. Set RUNPOD_API_KEY in your environment, or run runpodctl doctor yourself to save it to ~/.runpod/config.toml. SKILL.md tells agents to use the environment variable because doctor is interactive.

Will it cost me money?

Creating pods and endpoints bills your Runpod account while they run. SKILL.md warns that a worker minimum of 1 bills continuously, and that a stopped pod still bills for disk. The skill itself is free.

Is runpodctl safe to run with an agent?

It acts on real, billable infrastructure with your key. Read each create and delete command before you approve it, and use a key you can revoke. Our advice: do not give the agent blanket approval to clean up resources you did not ask it to create.

Is this the official Runpod skill?

Yes. It is in Runpod's own runpod-plugins-official repo, and the marketplace file and plugin manifest name Runpod as owner and author.

runpodctl or runpod-mcp?

Both drive the same Runpod API. SKILL.md says to use runpodctl for the terminal, CI, SSH setup, file transfer and doctor, and to prefer runpod-mcp for structured tool calls when the Runpod MCP tools are connected.

Does it work on Windows?

The skill's compatibility line says Linux and macOS, and the install note adds Windows through WSL.

Does it work in the Claude app or Codex?

The README documents Claude Code and Codex plugins, plus the skills CLI for other agents. The skill runs a local command line tool, so there is no Claude app upload option here.

Information

updated Nov 2, 2026

Folder
plugins/runpod/skills/runpodctl

runpod/runpod-plugins-officialskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 4
  1. README.md · github.com
  2. marketplace.json · github.com
  3. SKILL.md · github.com
  4. README.md · github.com

Updated Nov 2, 2026.