# Install tf-profile with Homebrew

CLI tool to profile Terraform runs. Version 0.5.0 via Homebrew; verified from local package data.

## 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
- **Package manager page:** <https://formulae.brew.sh/formula/tf-profile>
- **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>
- **Upstream docs:** <https://github.com/datarootsio/tf-profile#readme>
- **License:** MIT
- **Source archive:** <https://github.com/datarootsio/tf-profile/archive/refs/tags/v0.5.0.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- tf-profile (cli)
- tf-profile (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: 0.5.0
- Local data: ok
- Upstream repository: https://github.com/datarootsio/tf-profile
- Upstream latest detected: v0.5.0 (current)
- info: No package-manager update timestamp was available.
## 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

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** tf-profile
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **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.
- [cargo-flamegraph](https://www.automicvault.com/pkg/brew/cargo-flamegraph/) - Shares av.db curated category or tags: cli, developer-tools, performance, profiling.
- [counts](https://www.automicvault.com/pkg/brew/counts/) - Shares av.db curated category or tags: cli, developer-tools, performance, profiling.
- [flamebearer](https://www.automicvault.com/pkg/brew/flamebearer/) - Shares av.db curated category or tags: cli, developer-tools, performance, profiling.
- [flamegraph](https://www.automicvault.com/pkg/brew/flamegraph/) - Shares av.db curated category or tags: cli, developer-tools, performance, profiling.
- [gprof2dot](https://www.automicvault.com/pkg/brew/gprof2dot/) - Shares av.db curated category or tags: cli, developer-tools, performance, profiling.
- [iam-policy-json-to-terraform](https://www.automicvault.com/pkg/brew/iam-policy-json-to-terraform/) - Shares av.db curated category or tags: cli, developer-tools, infrastructure-as-code, terraform.
- [memray](https://www.automicvault.com/pkg/brew/memray/) - Shares av.db curated category or tags: cli, developer-tools, performance, profiling.
- [py-spy](https://www.automicvault.com/pkg/brew/py-spy/) - Shares av.db curated category or tags: cli, developer-tools, performance, profiling.
- [tf-summarize](https://www.automicvault.com/pkg/brew/tf-summarize/) - Package names and metadata indicate a similar tool family. Shared terms: cli, code, developer, developer-tools, infrastructure.
- [tfautomv](https://www.automicvault.com/pkg/brew/tfautomv/) - Local package facts share a topical domain. Shared terms: cli, code, developer, developer-tools, infrastructure.
- [tfclean](https://www.automicvault.com/pkg/brew/tfclean/) - 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/tf-profile.yml](https://github.com/automic-vault/db/blob/main/combined/tf-profile.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
