# Install litani with Homebrew

Metabuild system. Version 1.29.0 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:litani
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install litani
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:litani
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/litani>
- **Version:** 1.29.0
- **Source summary:** Metabuild system
- **Homepage:** <https://awslabs.github.io/aws-build-accumulator/>
- **Repository:** <https://github.com/awslabs/aws-build-accumulator>
- **Upstream docs:** <https://awslabs.github.io/aws-build-accumulator>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/awslabs/aws-build-accumulator.git>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- litani (cli)
- litani (alias)

## Dependencies

- gnuplot
- graphviz
- libyaml
- ninja
- python@3.14

## Build dependencies

- coreutils
- mandoc
- scdoc

## 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: 1.29.0
- Local data: ok
- Upstream repository: https://github.com/awslabs/aws-build-accumulator
- info: No package-manager update timestamp was available.
- info: No cached GitHub release or tag data was available.
## Project history and usage

Litani is an AWS Labs metabuild tool for accumulating command jobs into a dependency graph, running them through Ninja, and producing both a JSON run record and an HTML dashboard. It is aimed at builds where job metadata, failure policy, and reportability matter as much as command execution.

### Project history

The project is published from the `awslabs/aws-build-accumulator` repository and documents itself as a command-line build system rather than a new build language. Its workflow starts with `litani init`, adds jobs with dependencies, and runs the resulting graph with `litani run-build`.

Litani's documentation emphasizes build accumulation: commands can be generated by scripts, Makefiles, or other systems, while Litani records return codes, runtimes, stdout, stderr, and other metadata in JSON and renders that data into an HTML report.

### Adoption history

Adoption evidence is modest and mostly package-manager oriented. GitHub releases provide Debian packages and Homebrew installation instructions, and the Homebrew formula exposes the `litani` command for macOS users.

### How it is used

Users define jobs, dependencies, and failure behavior from the command line, then inspect `litani dump-run` output or the generated dashboard. The tool is most useful when an existing build needs reporting, dependency ordering, and durable run metadata without rewriting the build in a new DSL.

### Why package nerds care

Litani is package-nerd interesting because it is a thin orchestration layer over familiar tools: shell commands, Ninja, JSON, and static HTML. Its value is in making build execution observable and packageable, not in replacing compilers or build file formats.

### Timeline

- 2023-04-19: Release 1.24.0 provided Homebrew and Ubuntu package installation notes.
- 2026-03-02: Release 1.28.0 included Homebrew and Ubuntu package installation notes.
- 2026-06-12: Release 1.29.0 was published with Homebrew and Ubuntu package installation notes.

### Related projects

- Related projects include Ninja, Make, CMake, Graphviz, Gnuplot, Jinja, and other build-reporting or continuous-integration tools.

### Sources

- <https://awslabs.github.io/aws-build-accumulator/>
- <https://github.com/awslabs/aws-build-accumulator>
- <https://github.com/awslabs/aws-build-accumulator/releases>


## Security Notes

generalized runtime or code generation signal.

- **Geiger risk:** yellow / medium
- generalized runtime or code generation signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** litani
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** 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.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [gnuplot](https://www.automicvault.com/pkg/brew/gnuplot/) - Runtime dependency declared by Homebrew.
- [graphviz](https://www.automicvault.com/pkg/brew/graphviz/) - Runtime dependency declared by Homebrew.
- [ninja](https://www.automicvault.com/pkg/brew/ninja/) - Runtime dependency declared by Homebrew.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [coreutils](https://www.automicvault.com/pkg/brew/coreutils/) - Build dependency declared by Homebrew.
- [mandoc](https://www.automicvault.com/pkg/brew/mandoc/) - Build dependency declared by Homebrew.
- [scdoc](https://www.automicvault.com/pkg/brew/scdoc/) - Build dependency declared by Homebrew.
- [bsdmake](https://www.automicvault.com/pkg/brew/bsdmake/) - Shares av.db curated category or tags: build-system, cli, developer-tools.
- [cabin](https://www.automicvault.com/pkg/brew/cabin/) - Shares av.db curated category or tags: build-system, cli, developer-tools.
- [dune](https://www.automicvault.com/pkg/brew/dune/) - Shares av.db curated category or tags: build-system, cli, developer-tools.
- [fastbuild](https://www.automicvault.com/pkg/brew/fastbuild/) - Shares av.db curated category or tags: build-system, cli, developer-tools.
- [goredo](https://www.automicvault.com/pkg/brew/goredo/) - Shares av.db curated category or tags: build-system, cli, developer-tools.
- [mk-configure](https://www.automicvault.com/pkg/brew/mk-configure/) - Shares av.db curated category or tags: build-system, cli, developer-tools.
- [muon](https://www.automicvault.com/pkg/brew/muon/) - Shares av.db curated category or tags: build-system, cli, developer-tools.
- [redo](https://www.automicvault.com/pkg/brew/redo/) - Both packages touch the same language runtime or ecosystem. Shared terms: build, build-system, cli, developer, developer-tools.
- [scons](https://www.automicvault.com/pkg/brew/scons/) - Both packages touch the same language runtime or ecosystem. Shared terms: build, build-system, cli, developer, developer-tools.
- [meson](https://www.automicvault.com/pkg/brew/meson/) - Both packages touch the same language runtime or ecosystem. Shared terms: build, build-system, cli, developer, developer-tools.

## Combined YAML source

View the package source record on GitHub. [combined/litani.yml](https://github.com/automic-vault/db/blob/main/combined/litani.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
