productivity
RunPod CLI for Headless Automation
Use the RunPod CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 7 read 0 write Bearer token auth
RunPod CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The RunPod CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# RunPod CLI for Headless Automation
kosmokrator integrations:configure runpod --set access_token="$RUNPOD_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call runpod.runpod_list_pods '{}' --json Discovery Before Execution
Agents and scripts can inspect RunPod docs and schemas before choosing a function.
kosmo integrations:docs runpod --json
kosmo integrations:docs runpod.runpod_list_pods --json
kosmo integrations:schema runpod.runpod_list_pods --json
kosmo integrations:search "RunPod" --json
kosmo integrations:list --json Useful RunPod CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
runpod.runpod_list_pods | Read | none | List all GPU pods in your RunPod account. Returns pod IDs, names, status, GPU types, and runtime details. |
runpod.runpod_get_pod | Read | pod_id | Get detailed information about a specific RunPod GPU pod, including its status, GPU type, runtime, ports, and configuration. Use the pod ID obtained from runpod_list_pods. |
runpod.runpod_list_templates | Read | none | List all available RunPod templates. Returns template IDs, names, images, and machine configurations. |
runpod.runpod_list_network_volumes | Read | none | List all network volumes in your RunPod account. Returns volume IDs, names, sizes, and data center information. |
runpod.runpod_list_endpoints | Read | none | List all RunPod endpoints. Returns endpoint IDs, names, statuses, and configuration details. |
runpod.runpod_list_serverless | Read | none | List all serverless endpoints in your RunPod account. Returns endpoint IDs, names, statuses, and worker configurations. |
runpod.runpod_get_current_user | Read | none | Get the profile of the currently authenticated RunPod user, including name, email, and account details. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.