pug
A terminal user interface for Terraform power users, enabling parallel operations and interactive state management.
What is pug?
Pug is a terminal user interface (TUI) designed for advanced Terraform users, providing a fast and interactive way to manage infrastructure as code. It enhances the Terraform workflow by allowing parallel execution of tasks and offering a rich interface for state and resource management.
Infrastructure engineers and DevOps practitioners who are power users of Terraform, OpenTofu, or Terragrunt and work with complex, multi-module environments.
Developers choose Pug for its keyboard-driven interface that enables parallel task execution across modules and workspaces, interactive state management with direct shortcuts, and seamless integration with tools like Infracost and Terragrunt, significantly accelerating infrastructure management workflows.
Overview
Drive terraform at terminal velocity.
Use Cases
Best For
- Managing Terraform modules and workspaces in parallel to speed up plans and applies.
- Interactively targeting, moving, or tainting specific resources within Terraform state via keyboard shortcuts.
- Working with Terragrunt projects, including automatic dependency resolution and topological ordering for applies.
- Integrating cost estimation directly into the TUI using Infracost for selected workspaces.
- Automatically loading workspace-specific variable files (e.g., dev.tfvars) based on the active workspace name.
- Using multiple Terraform versions per module with version managers like asdf or mise via arbitrary command execution.
Not Ideal For
- Teams that rely exclusively on GUI-based infrastructure tools like Terraform Cloud's web interface
- Projects with only a single, static Terraform module and no need for workspace management
- Environments requiring detailed, automated audit logs for all command executions without manual intervention
- Users who prefer mouse-driven interfaces over keyboard shortcuts for all operations
Pros & Cons
Pros
Enables concurrent runs of Terraform commands like plan and apply across multiple modules or workspaces, speeding up workflows. The README shows key bindings for multi-select and a default max-tasks of 32.
Provides direct keyboard shortcuts for targeting, moving, tainting, and deleting resources in Terraform state. The state pane key bindings include 'p' for plan -target and 'D' for state rm.
Works seamlessly with Terraform, OpenTofu, and Terragrunt, including automatic dependency resolution. The README details Terragrunt mode for topological ordering and Tofu support via --program flag.
Automatically loads variable files like dev.tfvars based on workspace names, reducing manual steps. The workspace variables section explains how it passes -vars-file for plans.
Cons
Requires a patched nerdfonts font to render icons properly, adding an extra setup step that may not be available in all terminals or environments.
Uses overlapping configuration methods (flags, environment variables, YAML files), which can be confusing to manage and debug, as noted in the configuration section.
Lacks a graphical UI, making it unsuitable for users who prefer visual tools or need accessibility features beyond keyboard navigation.
Open Source Alternative To
pug is an open-source alternative to the following products:
Frequently Asked Questions
Related Projects
terraformerCLI tool to generate terraform files from existing infrastructure (reverse Terraform). Infrastructure to Code
InfracostCloud cost intelligence for engineers, AI coding agents, and CI/CD 💰📉 Shift FinOps Left!
TerragruntTerragrunt is a flexible orchestration tool that allows Infrastructure as Code written in OpenTofu/Terraform to scale.
atlantisTerraform Pull Request Automation
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.