# Install terramaid with Homebrew

Utility for generating Mermaid diagrams from Terraform configurations. Version 2.15.3 via Homebrew; verified 2026-07-26.

## Install

```sh
sudo av install brew:terramaid
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install terramaid
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:terramaid
- **Package manager:** Homebrew
- **Version:** 2.15.3
- **Source summary:** Utility for generating Mermaid diagrams from Terraform configurations
- **Homepage:** <https://github.com/RoseSecurity/Terramaid>
- **Repository:** <https://github.com/RoseSecurity/Terramaid>
- **Last updated:** 2026-07-26T00:50:37+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- terramaid (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 2.15.3
## Project history and usage

Terramaid is a RoseSecurity CLI that turns Terraform configurations and plans into Mermaid diagrams for documentation and review workflows.

### Project history

The public repository was created in May 2024. The README presents Terramaid as a utility for creating Mermaid diagrams from Terraform configurations and explains that it converts infrastructure resources and plans into diagrams that can be used in documentation and collaboration.

The project sits at the intersection of Terraform, Mermaid, and CI documentation. Its README shows generated Mermaid flowchart output, supports CLI parameters and environment variables, and documents Homebrew, Go, apt, Nix, source, Docker, GitHub Actions, and GitLab CI/CD usage paths.

### Adoption history

The project is newer and adoption appears early-stage. Repository metadata showed a small public audience by July 2026, while the README already documented several package and CI distribution paths, indicating an intent to make the tool easy to drop into developer and pipeline environments.

### How it is used

The main workflow is terramaid run, optionally pointing at a working directory, Terraform binary, Terraform plan file, output path, chart type, direction, and subgraph name.

In CI, Terramaid can generate diagram artifacts from Terraform configurations or plans so reviewers get visual context alongside infrastructure changes.

### Why package nerds care

For package nerds, Terramaid is interesting because it packages documentation generation as a normal CLI install. The same tool can be reached through Homebrew, Go install, apt repository setup, Nix flakes, Docker, or source builds.

### Timeline

- 2024: Public GitHub repository created.
- 2024: README documents Terraform-to-Mermaid diagram generation and multiple installation channels.
- 2026: Homebrew metadata lists terramaid as a brew formula.

### Related projects

- Terraform supplies the configuration and plan input.
- Mermaid supplies the diagram syntax emitted by Terramaid.
- OpenTofu is listed among repository topics and occupies the same IaC ecosystem.

### Sources

- Input package metadata: source_facts.package-manager, source_facts.package-manager-url
- README: https://github.com/RoseSecurity/Terramaid#readme
- Repository metadata: https://api.github.com/repos/RoseSecurity/Terramaid


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/terramaid.yml](https://github.com/mxcl/pkgdb/blob/main/combined/terramaid.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph