poddle task

Run a coding agent headless on a prompt in a fresh secretless pod

Usage

$ poddle task <prompt>

Examples

>_zsh

# one-shot autonomous run in a fresh pod, torn down after
poddle task "add tests for parseConfig" --identity work
# burst to a strong pod and keep it to inspect afterward
poddle task "port the module to v2" --size strong --keep --identity work

Flags

Flag	Type	Default	Description
`--autoscale`	bool	`false`	let poddled auto-grow this pod to a bigger shell when it nears its memory limit
`--detach, -d`	bool	`false`	run the agent in the background; leave the pod up (poddle logs/down)
`--harness`	string	`claude-code`	coding-agent runtime
`--identity`	string	-	coding-agent login to use (required unless the template sets one)
`--image`	string	`docker.io/library/debian:stable-slim`	base image
`--keep`	bool	`false`	keep the pod running after the task (attach/inspect later)
`--max-turns`	int	`24`	maximum agent turns
`--name`	string	-	pod name (default: a generated poddle-task-* name)
`--policy`	string	-	governance policy to enforce on the pod's egress (from ~/.config/poddle/policies)
`--size`	string	`weak`	resource size (weak\|strong)
`--template`	string	-	template to base the pod on

← All commands