# Install tf-profile with Homebrew

CLI tool to profile Terraform runs. Version 0.5.0 via Homebrew; verified 2026-07-26.

## Install

```sh
sudo av install brew:tf-profile
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tf-profile
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:tf-profile
- **Package manager:** Homebrew
- **Version:** 0.5.0
- **Source summary:** CLI tool to profile Terraform runs
- **Homepage:** <https://github.com/datarootsio/tf-profile>
- **Repository:** <https://github.com/datarootsio/tf-profile>
- **Last updated:** 2026-07-26T00:50:38+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- tf-profile (alias)

## Install behavior

- Bottle: not available

## Freshness

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

tf-profile is a Go command-line profiler for Terraform runs. It reads Terraform logs from standard input or files and summarizes resource-level timing, aggregate run statistics, filters, and Gantt-like visualizations.

### Project history

The public repository began in March 2023 with commits for stdin reading, Terraform log parsing, and tabular output. The README describes a Cobra-based CLI that can generate global stats, resource-level stats, filters, and visualizations.

The project reached v0.5.0 in October 2024. Its README now warns that it is no longer actively developed and that no new features or support for newer Terraform versions are intended.

### Adoption history

The README lists Homebrew, binary releases, Docker, and source builds as installation paths, and says the project was featured on awesome-go and awesome-terraform. That places it in the small-tool Terraform ecosystem where engineers install focused CLIs around the core `terraform` binary.

### How it is used

The intended workflow is to pipe `terraform apply` output to `tf-profile` or save logs and analyze them later. Users can ask for high-level stats, per-resource tables, filtered logs, or a gnuplot script for a run visualization.

### Why package nerds care

For package nerds, tf-profile is a single-purpose Terraform companion CLI: useful when installed through Homebrew or Docker, but also a cautionary package because the upstream README explicitly marks active development as ended.

### Timeline

- 2023-03-06: Initial commit
- 2023-04-16: release/0.0.1 tag
- 2023-07-16: v0.4.0 tag
- 2024-10-23: v0.5.0 tag
- 2026: README states the project is no longer actively developed

### Related projects

- Terraform supplies the logs that tf-profile parses.
- Cobra is used for the modern CLI structure.
- Gnuplot is used to render graph output generated by tf-profile.

### Sources

- Official git tags and commit history from https://github.com/datarootsio/tf-profile
- <https://github.com/datarootsio/tf-profile/blob/main/README.md>


## 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/tf-profile.yml](https://github.com/mxcl/pkgdb/blob/main/combined/tf-profile.yml)


## Sources

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