tofu-tree 0.3.0

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

+-± local_file
│  ├── - nested_docs
│  │   ├── - nested_docs: changelog
│  │   ├── - nested_docs: license
│  │   └── - nested_docs: readme
│  │
│  ├── + nested_docs_2
│  │   ├── + nested_docs_2: changelog
│  │   ├── + nested_docs_2: license
│  │   └── + nested_docs_2: readme
│  │
│  └── +-± scripts
│      ├── - scripts: backup
│      ├── + scripts: create
│      └── ± scripts: deploy
│

+   4 to be created
-   4 to be destroyed
±   1 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