# 使用 Homebrew, Nix, winget 安装 terramate

查看 terramate 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:terramate
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install terramate
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#terramate
```

  证据: nixpkgs package indexes: pkgs/by-name/te/terramate/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- winget (92%):

```sh
winget install --id Terramate.CLI -e
```

  证据: Windows Package Manager source index: Terramate.CLI from https://cdn.winget.microsoft.com/cache/source.msix

## 软件包事实

- **软件包键:** brew:terramate
- **软件包管理器:** Homebrew
- **版本:** 0.17.2
- **来源摘要:** Managing Terraform stacks with change detections and code generations
- **主页:** <https://terramate.io/docs/>
- **仓库:** <https://github.com/terramate-io/terramate>
- **最后更新:** 2026-07-31T13:29:11Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- terramate-ls (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

- 页面生成时间: 2026-08-03
- 管理器版本: 0.17.2
## 项目历史与用法

Terramate is an open-source Infrastructure as Code orchestration and code-generation CLI for Terraform, OpenTofu, Terragrunt, Kubernetes, and CI/CD workflows.

### 项目历史

The public Terramate repository was created in September 2021. Its README describes Terramate CLI as an open-source orchestration and code generation engine for scaling IaC, with optional pairing to Terramate Cloud for managed observability, drift detection, asset management, policy, and notification features.

Terramate's project model is built around stacks. The README emphasizes breaking large infrastructure into smaller stacks, reducing duplicated configuration through generated HCL, JSON, or YAML, and orchestrating commands across stacks with a graph-based engine.

The official CLI docs describe Terramate as a daily IaC workload tool for managing stacks, maintaining a DRY codebase with code generation, planning and deploying with orchestration and change detection, and synchronizing data with Terramate Cloud.

### 采用历史

Terramate is newer than Terragrunt but has become a visible Terraform/OpenTofu orchestration package. Repository metadata showed several thousand stars by July 2026, and input package metadata lists Homebrew, Nix, and winget packages.

The README's onboarding claims are aimed at incremental adoption: existing Terraform, OpenTofu, or Terragrunt projects can start with a single command and without refactoring, while teams can adopt features individually to avoid hard lock-in.

### 使用方式

Common CLI usage includes creating and listing stacks, running commands such as terraform init or terraform apply across all or changed stacks, generating repeated backend and provider configuration, and filtering execution by Git changes, tags, directories, or Terramate Cloud status.

The official change-detection docs explain the --changed workflow for running commands only in stacks affected by a commit, branch, or pull request. The code-generation docs describe generating stack files from blueprints to keep Terraform backend and provider configuration DRY.

### 为什么软件包爱好者会关心

For package-manager users, Terramate is significant because it packages a higher-level IaC workflow engine as a single CLI. It is useful in dev shells and CI images where users already install Terraform, OpenTofu, or Terragrunt and want change detection, orchestration, and generated configuration without adopting a hosted CI product.

Its cross-platform package metadata, Go-based install path, and optional Cloud pairing make it both a local CLI package and an entry point into a larger IaC platform.

### 时间线

- 2021: Public Terramate repository created.
- 2020s: CLI docs establish stack management, code generation, orchestration, and change detection as core workflows.
- 2026: Homebrew, Nix, and winget metadata list Terramate CLI packages.

### Related projects

- Terraform and OpenTofu are primary IaC engines Terramate orchestrates.
- Terragrunt is explicitly supported as an existing project style that Terramate can onboard.
- Terramate Cloud is the optional managed service paired with the open-source CLI.

### 来源

- CLI reference: https://terramate.io/docs/cli/reference/cmdline/
- Change detection docs: https://terramate.io/docs/cli/change-detection/
- Code generation docs: https://terramate.io/docs/cli/code-generation/
- Docs: https://terramate.io/docs
- Input package metadata: source_facts.package-manager
- README: https://github.com/terramate-io/terramate#readme
- Repository metadata: https://api.github.com/repos/terramate-io/terramate


## 安全说明

narrow executable package without higher-risk signals.

- **Geiger 风险:** 绿色 / 低
- narrow executable package without higher-risk signals


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: <project>/**/*.tm.hcl, <project>/**/*.tm
## 其他软件包管理器记录

- Nix - terramate: normalized package name match | nixpkgs package indexes: pkgs/by-name/te/terramate/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- winget - Terramate.CLI: normalized package name match | Windows Package Manager source index: Terramate.CLI from https://cdn.winget.microsoft.com/cache/source.msix


## Combined YAML source

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


## 来源

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph