# Install swiftplantuml with Homebrew

Generate UML class diagrams from Swift sources. Version 0.8.1 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:swiftplantuml
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install swiftplantuml
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:swiftplantuml
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/swiftplantuml>
- **Version:** 0.8.1
- **Source summary:** Generate UML class diagrams from Swift sources
- **Homepage:** <https://marcoeidinger.github.io/SwiftPlantUML/>
- **Repository:** <https://github.com/MarcoEidinger/SwiftPlantUML>
- **Upstream docs:** <https://github.com/MarcoEidinger/SwiftPlantUML#readme>
- **License:** MIT
- **Source archive:** <https://github.com/MarcoEidinger/SwiftPlantUML/archive/refs/tags/0.8.1.tar.gz>
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- swiftplantuml (cli)
- swiftplantuml (alias)

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, monterey, sonoma, ventura

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.8.1
- Local data: ok
- Upstream repository: https://github.com/MarcoEidinger/SwiftPlantUML
- Upstream latest detected: 0.8.1 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

SwiftPlantUML is a Swift CLI and Swift Package that generates PlantUML class diagrams from Swift source. It occupies a smaller but recognizable package-manager niche: source-code documentation tooling that can be installed with Homebrew or Mint and run from a project checkout.

### Project history

The GitHub repository was created in January 2021. The official README describes a command-line tool and Swift Package for generating class diagrams powered by PlantUML from Swift files.

The project grew around SourceKit-backed Swift source inspection. Its README documents command-line operation, Swift Package use, an Xcode source editor extension, and configuration through `.swiftplantuml.yml`.

### Adoption history

Official installation instructions include Homebrew, Mint, and source builds. The README also notes that the Homebrew installation previously used the maintainer's tap before the plain `brew install swiftplantuml` command became available.

GitHub release metadata shows public releases through the 0.8.x series in 2024. Compared with SwiftLint or SwiftFormat, the official record supports a narrower adoption story centered on diagram generation rather than general Swift build hygiene.

### How it is used

Common usage is running `swiftplantuml` or the default `classdiagram` subcommand against files or directories containing Swift sources. The tool can emit or view generated PlantUML output and can use `.swiftplantuml.yml` for includes, excludes, access-level filtering, relationship display, and theming.

Because SwiftPlantUML hooks into SourceKit, the README tells users to run it with the same Swift toolchain used to compile the code.

### Why package nerds care

SwiftPlantUML matters to package nerds as an example of a small Swift CLI that packages compiler-adjacent source inspection into a reusable tool. Its Homebrew and Mint support make architecture documentation reproducible without requiring every developer to build from source.

It also shows the packaging friction around SourceKit tools: the binary is simple to install, but correctness can still depend on the active Swift/Xcode toolchain.

### Timeline

- 2021: GitHub repository created.
- 2024: GitHub release metadata lists 0.8.0 and 0.8.1 releases.
- 2024: Generated API documentation was updated for the 0.8.1 release.

### Related projects

- Related projects include PlantUML, SourceKit, SwiftFormat, SwiftLint, Mint, Homebrew, and the separate SwiftPlantUML Xcode extension.

### Sources

- <https://api.github.com/repos/MarcoEidinger/SwiftPlantUML>
- <https://github.com/MarcoEidinger/SwiftPlantUML#readme>
- <https://marcoeidinger.github.io/SwiftPlantUML>
- input.source_facts.package-manager


## Security Notes

broad file, network, media, or database tool signal.

- **Geiger risk:** blue / medium
- broad file, network, media, or database tool signal

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** swiftplantuml
- **Version Scheme:** 0
- **Revision:** 0
- **Requirements:** macos, xcode
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **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.
- [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.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [overarch](https://www.automicvault.com/pkg/brew/overarch/) - Shares av.db curated category or tags: cli, developer-tools, diagram-generation, diagramming, plantuml.
- [clang-uml](https://www.automicvault.com/pkg/brew/clang-uml/) - Shares av.db curated category or tags: cli, developer-tools, diagramming, plantuml, uml.
- [eralchemy](https://www.automicvault.com/pkg/brew/eralchemy/) - Shares av.db curated category or tags: cli, developer-tools, diagram-generation, diagramming.
- [plantuml](https://www.automicvault.com/pkg/brew/plantuml/) - Shares av.db curated category or tags: cli, developer-tools, diagramming, uml.
- [sdedit](https://www.automicvault.com/pkg/brew/sdedit/) - Shares av.db curated category or tags: cli, developer-tools, diagramming, uml.
- [umlet](https://www.automicvault.com/pkg/brew/umlet/) - Shares av.db curated category or tags: cli, developer-tools, diagramming, uml.
- [d2](https://www.automicvault.com/pkg/brew/d2/) - Shares av.db curated category or tags: cli, developer-tools, diagramming.
- [diagram](https://www.automicvault.com/pkg/brew/diagram/) - Shares av.db curated category or tags: cli, developer-tools, diagramming.

## Combined YAML source

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