# 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
- **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>
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- swiftplantuml (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.8.1
## 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


## Combined YAML source

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


## Sources

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