A production-grade CLI and interactive command center for Terraform and OpenTofu. Doctor diagnostics, built-in policy checks, a web UI, drift detection, cost insights, 5 themes, and 20+ commands — works equally well for learning and day-to-day operations.
Install in 10 seconds
pip install infra-guidePython 3.8+Requires Terraform or OpenTofu in PATH. No API keys, no telemetry, no cloud credentials.
Quick start
infra-guideopen interactive TUIinfra-guide doctorworkspace health checkinfra-guide policysecurity policy scaninfra-guide webbrowser command centerBuilt by CloudGrains · Kolhapur, India
infra guide (written as infra-guide) is a free, open-source CLI and interactive command center for Terraform and OpenTofu, built by CloudGrains. It blends a guided TUI for learners with direct subcommands for production workflows — both backed by the same engine.
The tool introduces three capabilities you don't get from raw Terraform: a Doctor mode that audits workspace health and flags issues before you run anything; a built-in policy engine that checks your plan against security rules like no-public-S3 and open security groups; and a web command center that gives you a browser UI powered by the same backend as the terminal.
On top of that, infra guide adds cost insight (AWS cost hints from plan JSON before apply), drift detection, state file exploration, workspace management, CI/CD pipeline mode, shell completion for bash/zsh/fish, command history with favorites, and five visual themes — all offline, with no telemetry or credential handling.
infra guide is available on PyPI. Install with pip install infra-guide and run infra-guide doctor to get started.
Who it's for
Terraform & OpenTofu users, beginner to advanced
How to install
pip install infra-guide (Python 3.8+)
License
MIT — free forever, open source
infra guide goes beyond a menu wrapper — it adds diagnostics, security, visibility, and automation that raw Terraform doesn't provide out of the box.
Full workspace diagnostics — validates config, checks backend, counts variables, flags drift. Run before every apply to catch issues early.
Six security policies out of the box: no public S3, open ingress, missing tags, missing encryption, S3 versioning, and default VPC usage.
Run infra-guide web to open a browser UI at localhost:8765 powered by the same backend. Everything the TUI does, in a graphical interface.
Before you apply, infra guide analyses your saved plan JSON and surfaces AWS cost-impact hints — so you know what a change will cost before it runs.
aurora, sunset, forest, mono, and neon — persisted across sessions. Switch with infra-guide theme --set neon. Makes the terminal feel like yours.
One-line shell completion setup for bash, zsh, and fish. Plus a dedicated cicd mode for pipeline-friendly init/validate/plan with exit codes.
Every command runs locally. No internet, no credentials, no telemetry.
| Command | Description | Risk |
|---|---|---|
infra-guide | Open interactive TUI dashboard | Low |
infra-guide doctor | Workspace health diagnostics + recommendations | Low |
infra-guide doctor --with-drift | Health check + drift detection | Low |
infra-guide status | Fast workspace summary panel | Low |
infra-guide init | Initialize providers, modules, backend | Low |
infra-guide plan --out tfplan | Preview changes and save plan | Low |
infra-guide apply --plan-file tfplan --yes | Apply with cost insight | Medium |
infra-guide destroy --yes | Delete managed infrastructure | High |
infra-guide policy | Run built-in security policy checks | Low |
infra-guide drift | Detect infrastructure drift | Low |
infra-guide state --tree | Explore state file (list / tree / detail) | Low |
infra-guide web | Launch local browser command center | Low |
infra-guide workspace --list | Manage workspaces | Low |
infra-guide theme --set neon | Change active theme (5 themes) | Low |
infra-guide cicd | Pipeline-friendly init/validate/plan flow | Medium |
infra-guide fmt | Format HCL files | Low |
infra-guide output | Show infrastructure output values | Low |
infra-guide validate | Pre-flight validation checks | Low |
infra-guide history | Recent commands and favorites | Low |
infra-guide completion bash | Shell completion (bash / zsh / fish) | Low |
infra guide (written as infra-guide) is a free, open-source interactive terminal UI and direct CLI tool built by CloudGrains for Terraform and OpenTofu users. It provides a menu-driven interface, doctor diagnostics, built-in policy checks, a web command center, and 20+ direct subcommands — all without cloud credentials or telemetry. Install with pip install infra-guide.
Install infra guide with pip (pip install infra-guide) or pipx (pipx install infra-guide). Requires Python 3.8+ and Terraform or OpenTofu in your system PATH. Run infra-guide to open the interactive TUI, or infra-guide doctor for a quick workspace health check.
infra-guide doctor runs a full workspace health check — it validates your configuration, checks for common issues, and gives actionable recommendations. Add --with-drift to also detect infrastructure drift (differences between your Terraform state and actual cloud resources) in the same command.
Yes. Run infra-guide policy to check your Terraform plan against six built-in security policies: no public S3 buckets, no open security group ingress, required tags, encryption enforcement, S3 versioning, and no default VPC usage. You can also pass a saved plan JSON with --plan-file.
infra-guide web launches a local browser command center at http://localhost:8765 powered by the same backend as the TUI. It gives you a graphical interface for running Terraform commands without leaving your browser. Use --port to change the port or --no-browser to start the server only.
Yes. infra guide is completely free and open source under the MIT License. There are no paid tiers, no telemetry, no API keys, and no cloud credentials required. The source code is on GitHub at github.com/cloudgrains/infra-guide.
Yes. infra guide automatically detects whether Terraform or OpenTofu is installed and uses the correct binary. All commands — doctor, plan, apply, policy, drift, state, workspace — work identically with both tools.
infra guide ships with five themes: aurora (default), sunset, forest, mono, and neon. Change theme with infra-guide theme --set neon. Your selected theme persists across sessions.
infra guide is on PyPI at pypi.org/project/infra-guide. Install with pip install infra-guide or pipx install infra-guide. Source code is at github.com/cloudgrains/infra-guide under the MIT License.
Free, offline, open source. Doctor, policy, web UI — all included.
pip install infra-guide