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
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
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
- Install
- Quick start
- Live Help Is Authoritative
- Output & errors
- Decision Rules
- Serverless facts (context, not rules)
- Commands
- Pods
- Hub
- Serverless (alias: sls)
- Templates (alias: tpl)
- Network Volumes (alias: nv)
- Models (Model Repository)
- Info & SSH
- File Transfer
- Utilities
Key facts
- Author
- Runpod (vendor's own repo; the marketplace file and plugin manifest name Runpod as owner and author)
- Installs on skills.sh
- 14,791 as of 2026-11-02
- What is inside
- 21 files including SKILL.md: 3 reference guides and 17 eval cases. It bundles no scripts.
- 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 ·
PodsCreate, 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 ·
ServerlessFind 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 templatesList, 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 volumesUpload 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 ·
ModelsAccount, 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 SSHsend 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 transferdoctor, 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 ·
UtilitiesJSON 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 to | api.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 keys | RUNPOD_API_KEY from the environment, or the key that runpodctl doctor writes to ~/.runpod/config.toml (per the README). |
| Scopes |
|
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
- Repository
- runpod/runpod-plugins-official
- Folder
plugins/runpod/skills/runpodctl
Sources
Docs, issue trackers and discussions this page is built from.
Show all 4Hide
- README.md · github.com
- marketplace.json · github.com
- SKILL.md · github.com
- README.md · github.com