Skip to content

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.

  • 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.yaml declare 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.