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
submitfor new jobs. - Use
-syncto hit RunPod's synchronousrunsyncpath. - Use
-inputor-payloadto pass JSON or YAML input. - Use
-raw-bodyonly when the payload already contains the full RunPod request body. - Use
status,result, orcancelwith-request. - Set
RUNPOD_API_KEY,RUNPOD_ENDPOINT_ID, and optionallyRUNPOD_BASE_URLthrough the environment when possible. - Prefer
-format jsonor-format yamlfor 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"