CLI & API
Cloud agents (CLI)
Launch and track cloud agents from the terminal — the same background runs you get in the app.
The cloud subcommands drive cloud agents: ephemeral sandboxes that clone a repo, do the work, and open a PR.
Launch a run
goatfied cloud run "add a health check endpoint" \ --repo https://github.com/acme/api --branch main
The command prints the new session id and its initial state. The agent works on a fresh branch off --branch (defaults to the repo’s default branch).
Track and inspect
goatfied cloud ls # list recent cloud sessions goatfied cloud show <id> # state, branch, PR url, cost, artifacts
Resume
Continue a finished or snapshotted run in the cloud:
goatfied cloud resume <id>
To bring a run onto your machine instead, use Move to local from the Agents Window — see Cloud agents.
Next