Docs · Examples

See it work.

Representative sessions. The commands, flags, and output formats are real; the run narration is illustrative.

Run an agent headless

Give poddle task a prompt and it runs a coding agent to completion in a throwaway pod - the broker injects credentials on the wire, never into the pod.

>_zsh

poddle task "port the auth module to the new API" --identity work --size strong
→ pod poddle-task-4c71 up (strong) · broker attached
→ claude-code · turn 12/24 · 7 files changed
✓ done in 3m41s · pod torn down

Add --detach to leave it running in the background, then follow along with poddle logs.

Spin up, inspect, tear down

>_zsh

poddle up api --identity work --detach
a1b2c3d4e5f6
poddle ls
ID            NAME  TEMPLATE  SIZE  STATE    REPO
a1b2c3d4e5f6  api   base      weak  running  -
poddle down api

Run against a remote host

Point PODDLE_HOST at an SSH target and every command runs there - same flags, remote pods.

>_zsh

export PODDLE_HOST=ssh://build@10.0.0.5
poddle up big --identity work --size strong
→ big up (strong) on build@10.0.0.5 · broker attached

← Get started Connectors →Templates →Command reference →