# Install terramaid with Homebrew

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

## 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
- **Package manager page:** <https://formulae.brew.sh/formula/terramaid>
- **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>
- **Upstream docs:** <https://github.com/RoseSecurity/Terramaid#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/RoseSecurity/Terramaid/archive/refs/tags/v2.15.3.tar.gz>
- **Last updated:** 2026-07-04T07:25:20+02:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- terramaid (cli)
- terramaid (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.15.3
- Package-manager updated: 2026-07-04
- Local data: ok
- Upstream repository: https://github.com/RoseSecurity/Terramaid
- Upstream latest detected: v2.15.3 (current)
## 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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** terramaid
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** yes
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [mermaid-cli](https://www.automicvault.com/pkg/brew/mermaid-cli/) - Shares av.db curated category or tags: cli, developer-tools, diagrams, documentation, mermaid.
- [action-docs](https://www.automicvault.com/pkg/brew/action-docs/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [adr-tools](https://www.automicvault.com/pkg/brew/adr-tools/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [adr-viewer](https://www.automicvault.com/pkg/brew/adr-viewer/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [cargo-docset](https://www.automicvault.com/pkg/brew/cargo-docset/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [cheat](https://www.automicvault.com/pkg/brew/cheat/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [context7-mcp](https://www.automicvault.com/pkg/brew/context7-mcp/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [cppman](https://www.automicvault.com/pkg/brew/cppman/) - Shares av.db curated category or tags: cli, developer-tools, documentation.
- [tfupdate](https://www.automicvault.com/pkg/brew/tfupdate/) - Local package facts share a topical domain. Shared terms: cli, code, configurations, developer, developer-tools.
- [k2tf](https://www.automicvault.com/pkg/brew/k2tf/) - Local package facts share a topical domain. Shared terms: cli, code, developer, developer-tools, infrastructure.

## Combined YAML source

View the package source record on GitHub. [combined/terramaid.yml](https://github.com/automic-vault/db/blob/main/combined/terramaid.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- cross-ecosystem install command graph
