# Install mani with Homebrew, MacPorts, Nix

CLI tool to help you manage repositories. Version 0.32.1 via Homebrew; verified 2026-07-29. Also installable with nix: nix profile install nixpkgs#mani.

## Install

```sh
sudo av install brew:mani
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install mani
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install mani
```

  Evidence: MacPorts ports tree: devel/mani/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#mani
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ma/mani/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:mani
- **Package manager:** Homebrew
- **Version:** 0.32.1
- **Source summary:** CLI tool to help you manage repositories
- **Homepage:** <https://manicli.com>
- **Repository:** <https://github.com/alajmo/mani>
- **Last updated:** 2026-07-29T17:04:50+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- mani (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 0.32.1
## Project history and usage

mani is a Go command-line tool for managing many repositories from one YAML inventory. It combines project metadata, cloning and synchronization, task definitions, filtering, and command execution across groups of repositories.

### Project history

The public repository was created in October 2019. The project's own background document says it was written because the author wanted a central place for many repositories, with names, URLs, descriptions, one-command cloning, ad-hoc or named commands across selected repositories, and an overview of repositories and command output.

mani's design centers on a user-editable YAML file instead of treating the config as an opaque state file. The documentation highlights projects, tasks, specs, targets, themes, and environment variables as the core concepts in `mani.yaml`.

### Adoption history

The README documents distribution through project releases, curl install, Homebrew, MacPorts, Arch AUR, Nix, Go install, and source builds. That package-manager spread reflects a niche but real audience among developers who maintain many Git repositories.

### How it is used

Typical use starts with `mani init` in a directory containing Git repositories, which generates a `mani.yaml` inventory. Users then run commands such as listing projects or executing `git status` across all projects, optionally in parallel and with tabular output.

### Why package nerds care

mani sits in the same tooling family as `myrepos`, `repo`, `vcstool`, `meta`, and other multi-repository helpers, but packages the workflow as a single Go binary with shell completion and a YAML-first configuration model.

### Timeline

- 2019: Public GitHub repository created.
- 2020-2021: README copyright years indicate early MIT-licensed public development.
- 2026: v0.32.1 release published on GitHub.

### Related projects

- The official project background names gita, gr, meta, mu-repo, myrepos, repo, and vcstool as similar software.
- The README points to the author's `sake` project as a related tool for managing servers.

### Sources

- <https://github.com/alajmo/mani>
- <https://github.com/alajmo/mani#readme>
- <https://github.com/alajmo/mani/blob/main/docs/config.md>
- <https://github.com/alajmo/mani/blob/main/docs/project-background.md>
- <https://github.com/alajmo/mani/releases/tag/v0.32.1>


## Security Notes

No matching local secret-handling manifest was found for mani. 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

- Linux: $XDG_CONFIG_HOME/mani/config.yaml, ~/.config/mani/config.yaml
- macOS: ~/Library/Application Support/mani/config.yaml
- Unix: mani.yaml, mani.yml, .mani.yaml, .mani.yml
## Other Package-Manager Records

- Nix - mani: normalized package name match | nixpkgs package indexes: pkgs/by-name/ma/mani/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- MacPorts - mani: normalized package name match | MacPorts ports tree: devel/mani/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Combined YAML source

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


## Sources

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph