Introduction

Terraplane is PR-driven Terraform automation with remote agents.

You comment on a pull request. You get a plan. You apply when ready. No sprawling platform to adopt first — just an orchestrator, agents, and a YAML file.

What makes it different is where Terraform runs, and how little you have to stand up to get there.

Early alpha

Terraplane is early alpha software. It works, and people are using it — but APIs, config, and behaviour can and will change between releases. Pin a version, read the changelog, and don’t treat it like finished production infrastructure yet.

The short version

• An orchestrator receives GitHub webhooks, tracks jobs and locks, and posts feedback on the PR.
• Agents poll the orchestrator over HTTP, claim jobs, and run Terraform where credentials and network access already live.
• terraplane.yaml maps environments and stacks to the agent that should handle them.

That split is the point. A lot of real infrastructure isn’t reachable from outside your environment. Agents sit inside the network that can already reach those resources; the orchestrator never needs a path in.

Next

• Why Terraplane — architecture and scope
• Quickstart — first plan from a PR
• GitHub — source, issues, releases