tofu-tree 0.3.5

A beautiful tree visualization tool for Terraform/OpenTofu plan output

tofu-tree

🌳 Simple tree visualization for Terraform/OpenTofu plan output

Transform your terraform plan or tofu plan output into an easy-to-read hierarchical tree structure with color-coded change indicators.

---

✨ Features

• 🌳 Beautiful Tree Output — Visualize your Terraform plan as a clean, hierarchical tree
• 🎨 Color-Coded Symbols — Instantly see what's being created (+), destroyed (-), replaced (±), or updated (~)
• 🔄 Auto-Detection — Automatically finds and runs tofu or terraform in your PATH
• 📊 Summary Statistics — Quick overview of total changes at a glance
• 📦 Zero Dependencies — Pure Python, works out of the box
• 🖥️ Cross-Platform — Works on Linux, macOS, and Windows

📦 Installation

pip install tofu-tree

Or with pipx for isolated installation:

pipx install tofu-tree

🚀 Quick Start

Run in a Terraform/OpenTofu directory

cd your-terraform-project
tofu-tree

Pipe plan output directly

tofu plan -concise -no-color | tofu-tree --input

Specify a directory

tofu-tree /path/to/terraform/project

📖 Usage

usage: tofu-tree [-h] [-V] [--no-color] [--input] [path]

Parse Terraform/OpenTofu plan output and display as a beautiful tree

positional arguments:
  path           Path to the Terraform/OpenTofu directory (default: current directory)

options:
  -h, --help     show this help message and exit
  -V, --version  show program's version number and exit
  --no-color     Disable ANSI color output for symbols (color is enabled by default)
  --input, -i    Read plan output from stdin instead of running terraform/tofu plan

🎬 Example Output

$ tofu-tree .
+ local_file.bla

+ local_file.config_files
│  ├── + app
│  ├── + cache
│  └── + db
│      
+ module.nested_module
│  ├── + local_file.health_checks
│  │   ├── + api
│  │   ├── + web
│  │   └── + worker
│  │       
│  ├── + local_file.service_configs
│  │   ├── + api
│  │   ├── + web
│  │   └── + worker
│  │       
│  └── + local_file.service_deployments
│      ├── + api
│      ├── + web
│      └── + worker
│          

+  13 to be created
-   0 to be destroyed
±   0 to be replaced
~   0 to be updated

Symbol Legend

Symbol	Color	Meaning
+	🟢 Green	Resource will be created
-	🔴 Red	Resource will be destroyed
±	🟣 Magenta	Resource will be replaced (destroy + create)
~	🟡 Yellow	Resource will be updated in-place

🔧 How It Works

1. Parse — Reads Terraform/OpenTofu plan output (concise format with -concise flag)
2. Build — Constructs a hierarchical graph from resource addresses
3. Display — Renders the graph as a tree with proper connectors (├──, └──)
4. Summarize — Shows counts of created, destroyed, replaced, and updated resources

🤝 Contributing

Contributions are welcome! Here's how to get started:

# Clone the repository
git clone https://github.com/yourusername/tofu-tree.git
cd tofu-tree

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run linter
ruff check src tests

# Run type checker
mypy src/tofu_tree

If you like the idea please upvote this feature request Add short concise tree view output option for tofu plan #3619

📄 License

Hippocratic License 3.0 — see LICENSE for details.

This license includes ethical restrictions, including a prohibition on using this software to train artificial intelligence systems without explicit permission.

🙏 Acknowledgments

Inspired by the Unix tree command and the need for better Terraform plan visualization.

---

Vibe Coded with ❤️ for the Infrastructure as Code community