# Install aftman with Homebrew, winget

Toolchain manager for Roblox, the prodigal sequel to Foreman. Version 0.3.0 via Homebrew; verified 2026-05-13.

## Install

```sh
sudo av install brew:aftman
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install aftman
```

  Evidence: local Homebrew formula metadata

### Windows

- winget (92%):

```sh
winget install --id LPGhatguy.Aftman -e
```

  Evidence: Windows Package Manager source index: LPGhatguy.Aftman from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:aftman
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/aftman>
- **Version:** 0.3.0
- **Source summary:** Toolchain manager for Roblox, the prodigal sequel to Foreman
- **Homepage:** <https://github.com/LPGhatguy/aftman>
- **Repository:** <https://github.com/LPGhatguy/aftman>
- **Upstream docs:** <https://github.com/LPGhatguy/aftman#readme>
- **License:** MIT
- **Source archive:** <https://github.com/LPGhatguy/aftman/archive/refs/tags/v0.3.0.tar.gz>
- **Last updated:** 2026-05-13T09:48:36-04:00
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- aftman (cli)
- aftman (alias)

## Build dependencies

- pkgconf
- rust

## Uses from macOS

- bzip2

## Install behavior

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

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.3.0
- Package-manager updated: 2026-05-13
- Local data: ok
- Upstream repository: https://github.com/LPGhatguy/aftman
- Upstream latest detected: v0.3.0 (current)
## Project history and usage

Aftman is a command-line toolchain manager that installs project-specific tools from GitHub releases and switches between them through local and global aftman.toml files. Its README describes it as the successor to Foreman and now warns that the project is no longer maintained, recommending mise-en-place instead.

### Project history

The public Aftman repository was created in 2021. The README frames it as spiritually similar to Foreman, a project the author created at Roblox, but with exact version dependencies, commands for installing and upgrading tools, a trust prompt for new downloads, better executable storage, improved platform artifact selection, and less Roblox-specific positioning.

Aftman's release history in GitHub runs through the 0.2 series and v0.3.0 in 2024. The repository metadata marks it archived, so the package now represents a finished or retired tool rather than an actively maintained toolchain manager.

### Adoption history

Aftman spread through the Roblox-adjacent developer tooling ecosystem because it could pin tools such as Rojo per project while also supporting a global configuration in ~/.aftman/aftman.toml. The supplied package facts show distribution through Homebrew and Windows winget.

Its deprecation path is visible in the README itself: users are pointed at mise-en-place as a replacement. That makes Aftman relevant historically as a bridge between Roblox-specific Foreman workflows and more general-purpose tool version managers.

### How it is used

Users run aftman init to create an aftman.toml, aftman add to add GitHub-hosted tools, aftman install to install all tools listed in discovered config files, and aftman self-install to install or refresh Aftman's shims. Aftman supports local project config and a global ~/.aftman/aftman.toml.

For private GitHub tools or rate limits, Aftman 0.2.7 and later can read a GitHub personal access token from ~/.aftman/auth.toml. The README also documents a trust model for approving tools before automated installs.

### Why package nerds care

Aftman is interesting because the package is itself a package manager for other GitHub-release binaries. Downstream packagers have to decide whether an archived meta-tool should stay available for old projects even after upstream recommends migration.

Its config file shape is intentionally simple TOML, but the behavior lives in PATH shims and GitHub release asset selection, which are exactly the parts that make toolchain managers annoying and valuable.

### Timeline

- 2021: Aftman GitHub repository created.
- 2022: v0.2.x releases added features including list and GitHub authentication support.
- 2024: v0.3.0 released.
- 2025: Repository metadata shows the project archived.

### Related projects

- Foreman is the Roblox toolchain manager named by the README as Aftman's predecessor.
- Rojo is used in the README examples as a managed command-line tool.
- mise-en-place is the replacement recommended by the archived README.

### Sources

- <https://api.github.com/repos/LPGhatguy/aftman>
- <https://github.com/LPGhatguy/aftman#readme>
- <https://github.com/LPGhatguy/aftman/releases>
- source_facts.package-manager


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## 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: aftman.toml, ~/.aftman/aftman.toml

## Credential files

- Unix: ~/.aftman/auth.toml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** aftman
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** yes
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- winget - LPGhatguy.Aftman: normalized package name match | Windows Package Manager source index: LPGhatguy.Aftman from https://cdn.winget.microsoft.com/cache/source.msix


## 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.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [rgbds](https://www.automicvault.com/pkg/brew/rgbds/) - Shares av.db curated category or tags: cli, developer-tools, game-development, toolchain.
- [roblox-ts](https://www.automicvault.com/pkg/brew/roblox-ts/) - Shares av.db curated category or tags: cli, developer-tools, game-development, roblox.
- [rojo](https://www.automicvault.com/pkg/brew/rojo/) - Shares av.db curated category or tags: cli, developer-tools, game-development, roblox.
- [gdtoolkit](https://www.automicvault.com/pkg/brew/gdtoolkit/) - Shares av.db curated category or tags: cli, developer-tools, game-development.
- [arm-linux-gnueabihf-binutils](https://www.automicvault.com/pkg/brew/arm-linux-gnueabihf-binutils/) - Shares av.db curated category or tags: cli, developer-tools, toolchain.
- [cargo-msrv](https://www.automicvault.com/pkg/brew/cargo-msrv/) - Shares av.db curated category or tags: cli, developer-tools, toolchain.
- [ghcup](https://www.automicvault.com/pkg/brew/ghcup/) - Shares av.db curated category or tags: cli, developer-tools, toolchain.
- [hermit](https://www.automicvault.com/pkg/brew/hermit/) - Shares av.db curated category or tags: cli, developer-tools, toolchain.
- [goresym](https://www.automicvault.com/pkg/brew/goresym/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, development, foreman.
- [juliaup](https://www.automicvault.com/pkg/brew/juliaup/) - Local package facts share a topical domain. Shared terms: cli, developer, developer-tools, manager, toolchain.

## Combined YAML source

View the package source record on GitHub. [combined/aftman.yml](https://github.com/automic-vault/db/blob/main/combined/aftman.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
- external package-manager database matches
- cross-ecosystem install command graph
