Introduction
Terraplane is PR-driven Terraform automation with remote agents.
You comment on a pull request. You get a plan. You apply when ready. That part should feel familiar if you’ve used Atlantis.
What changes is where Terraform runs, and how work finds its way there.
The short version
Section titled “The short version”- An orchestrator receives GitHub webhooks, tracks jobs and locks, and posts feedback on the PR.
- Agents connect out over WebSocket and run Terraform where credentials and network access already live.
- Stacks in
terraplane.yamldeclare which agent 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.
- Why Terraplane — the architectural bet
- Quickstart — first plan from a PR
- GitHub — source, issues, releases