Agentrunpod CLI

Use the local `agentrunpod` CLI to submit, inspect, and cancel RunPod serverless jobs with structured output. Prefer it when an agent needs an env-configurable wrapper around the RunPod HTTP API instead of ad hoc curl commands.

SebastianBoehler 3f04b57 2 files · 1.6 KB Updated

File contents

AgentRunPod CLI

Use agentrunpod when a workflow needs a small deterministic wrapper around RunPod endpoint execution.

Invoke the Tool

Prefer the installed binary when it exists:

agentrunpod submit -endpoint "$RUNPOD_ENDPOINT_ID" -input payload.json

If working inside this repository or the binary is not installed, run:

go run ./cmd/agentrunpod -- submit -endpoint "$RUNPOD_ENDPOINT_ID" -input payload.json

Choose Flags

  • Use submit for new jobs.
  • Use -sync to hit RunPod's synchronous runsync path.
  • Use -input or -payload to pass JSON or YAML input.
  • Use -raw-body only when the payload already contains the full RunPod request body.
  • Use status, result, or cancel with -request.
  • Set RUNPOD_API_KEY, RUNPOD_ENDPOINT_ID, and optionally RUNPOD_BASE_URL through the environment when possible.
  • Prefer -format json or -format yaml for downstream agent parsing.

Examples

Submit a job:

go run ./cmd/agentrunpod -- submit -payload '{"prompt":"hello"}'

Fetch job status:

go run ./cmd/agentrunpod -- status -request "$JOB_ID"

SebastianBoehler/agent-cli-utils/tree/main/skills/agentrunpod-cli commit 3f04b57d84

Frequently asked questions

npx skillmds@latest add sebastianboehler/agentrunpod-cli