Magos is a Kubernetes-native operator for the declarative management of Terraform configurations.

The Magos operator manages the lifecycle of your infrastructure directly from Kubernetes. By defining a Workspace custom resource, Magos automates terraform plans and applies within your cluster.

• Go 1.25+
• Docker
• Kind
• Helm
• kubectl

Create a local Kind cluster:

make kind-cluster

Build all images, load them into the cluster, and install the chart:

make dev

Expose the UI and API to your browser:

make port-forward

In another terminal, apply the sample resources:

kubectl apply -f samples/marketplace-edge/
# or
kubectl apply -f samples/money-movement/

Observe what's running:

kubectl get projects,workspaces,rollouts -A
kubectl get jobs -A

Visit the Magos UI at http://localhost:8080 to see your Workspaces in action.

Tear down:

make uninstall
make kind-cluster-delete

We deeply value inner-source contributions, but ask you to approach them carefully—Magos's strength comes from stability, not flexibility. Every change must be evaluated against its impact on a large number of configurations, not just its technical brilliance. To ensure we maintain the project's clarity and reliability, we prioritize proposals over pull requests: this creates a record for discussion, and prevents wasted effort on misaligned work. While we strive to review every contribution (big or small), we're uncompromising about Magos's platform principles—we'll reject even clever solutions if they add significant complexity.

If you're considering a contribution, start with an issue or RFC—not code—so we can collaborate on the why before the how. This rigor is what keeps our Control Plane API stable and performant. Thank you for your understanding and commitment to making Magos better! 💛