# Install calm-cli with Homebrew CLI allows you to interact with the Common Architecture Language Model (CALM). Version 1.47.1 via Homebrew; verified 2026-06-30. ## Install ```sh sudo av install brew:calm-cli ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install calm-cli ``` Evidence: local Homebrew formula metadata ## Package facts - **Package key:** brew:calm-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 1.47.1 - **Source summary:** CLI allows you to interact with the Common Architecture Language Model (CALM) - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-06-30T15:24:06Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - calm (cli) - calm (alias) ## Dependencies - node ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 1.47.1 - Package-manager updated: 2026-06-30 - Local data: ok - Upstream repository: https://github.com/finos/architecture-as-code - info: No cached GitHub release or tag data was available. ## Project history and usage 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. ### Project history 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. ### Adoption history 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. ### How it is used 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. ### Why package nerds care 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. ### Timeline - 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. ### Sources - - - - - - input.json source_facts.package-manager ## Security Notes No matching local secret-handling manifest was found for calm-cli. Nucleus package metadata is still published here so future coverage has a stable package 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 ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** calm-cli - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Related links - [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. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [likec4](https://www.automicvault.com/pkg/brew/likec4/) - Shares av.db curated category or tags: architecture, architecture-as-code, cli, developer-tools. - [structurizr](https://www.automicvault.com/pkg/brew/structurizr/) - Shares av.db curated category or tags: architecture, cli, developer-tools. - [structurizr-cli](https://www.automicvault.com/pkg/brew/structurizr-cli/) - Shares av.db curated category or tags: architecture, cli, developer-tools. - [tach](https://www.automicvault.com/pkg/brew/tach/) - Shares av.db curated category or tags: architecture, cli, developer-tools. - [umlet](https://www.automicvault.com/pkg/brew/umlet/) - Shares av.db curated category or tags: cli, developer-tools, modeling. - [adr-tools](https://www.automicvault.com/pkg/brew/adr-tools/) - Shares av.db curated category or tags: architecture, cli, developer-tools. - [vscode-langservers-extracted](https://www.automicvault.com/pkg/brew/vscode-langservers-extracted/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, code, developer, developer-tools, language. - [aicommits](https://www.automicvault.com/pkg/brew/aicommits/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, developer, developer-tools, node, you. ## Combined YAML source View the package source record on GitHub. [combined/calm-cli.yml](https://github.com/automic-vault/db/blob/main/combined/calm-cli.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - cross-ecosystem install command graph