# 使用 Homebrew 安装 calm-cli

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

## 安装

```sh
sudo av install brew:calm-cli
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install calm-cli
```

  证据: local Homebrew formula metadata

## 软件包事实

- **软件包键:** brew:calm-cli
- **软件包管理器:** Homebrew
- **版本:** 1.51.0
- **来源摘要:** CLI allows you to interact with the Common Architecture Language Model (CALM)
- **主页:** <https://github.com/finos/architecture-as-code/tree/main/cli>
- **最后更新:** 2026-07-30T12:05:44Z
- **已生成:** 2026-08-03T19:37:03+00:00

## 可执行文件

- calm (别名)

## 安装行为

- Bottle: 不可用

## 版本和新鲜度

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

CALM CLI is the command-line interface for FINOS's Common Architecture Language Model, an Architecture as Code specification for defining, validating, comparing, templating, and documenting software architectures in a machine-readable form.

### 项目历史

The Architecture as Code repository was created under FINOS in November 2023 and contains the CALM specification plus official projects that use it. The repository README describes Architecture as Code as an effort to manage software architecture through a human- and machine-readable, version-controlled codebase.

The CALM CLI is one of the monorepo projects. Its README describes commands for generating architecture documents from CALM patterns, validating architectures against patterns, comparing documents, generating documentation, rendering templates, and initializing AI assistance for CALM work.

### 采用历史

CALM grew inside the FINOS Architecture as Code community, with the project README noting that it was developed as part of the FINOS DevOps Automation Special Interest Group before becoming a top-level project. The monorepo layout encourages official tooling, schemas, widgets, hub services, and plugins to be developed together.

The CLI is distributed through npm as @finos/calm-cli and through Homebrew as calm-cli, making the specification usable from ordinary developer terminals rather than only from documentation or web tools.

### 使用方式

Typical use starts with installing the CLI, then running calm generate to create an architecture from a pattern, calm validate to check an architecture against a pattern, calm diff to compare CALM documents, and calm docify or calm template to turn CALM models into generated documentation or files.

The CLI reads profile-level configuration from ~/.calm.json, with environment variables and command-line flags able to override settings such as remote host allowlists, authentication plugin paths, and CalmHub URLs.

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

For package-manager people, calm-cli is an example of architecture governance moving into the same installable CLI layer as linters, schema validators, and doc generators. It packages a finance-industry open-source specification into a command that can run in local shells and CI.

Its significance is less about raw install count and more about the emerging pattern: architecture diagrams and standards are becoming versioned artifacts with validators, generators, and package-manager distribution.

### 时间线

- 2023: FINOS architecture-as-code repository is created on GitHub.
- 2024: Repository license and copyright identify the project as a FINOS Apache-2.0 project.
- 2025: CALM branding and documentation appear in the official repository and documentation site.
- 2026: CLI v1.47.1 is published through the official GitHub releases feed.

### Related projects

- The CALM specification, CALM Hub, CALM Hub UI, CALM Server, CALM AI, CALM widgets, CALM Guard, CALM Studio, and the CALM VS Code plugin are listed as related projects in the same FINOS monorepo.
- The broader comparison set is schema-driven developer tooling: JSON Schema validators, OpenAPI-style contract tools, ADR tooling, and documentation generators.

### 来源

- <https://api.github.com/repos/finos/architecture-as-code>
- <https://api.github.com/repos/finos/architecture-as-code/releases>
- <https://calm.finos.org/>
- <https://github.com/finos/architecture-as-code>
- <https://github.com/finos/architecture-as-code/blob/main/cli/README.md>
- input.json source_facts.package-manager


## 安全说明

没有找到 calm-cli 的匹配本地密钥处理 manifest。Nucleus 软件包元数据仍在此发布，以便未来覆盖拥有稳定的软件包 URL。



## 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: ~/.calm.json

## Combined YAML source

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


## 来源

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