https://github.com/alajmo/mani
:robot: CLI tool to help you manage repositories
https://github.com/alajmo/mani
cli git golang
Last synced: about 2 months ago
JSON representation
:robot: CLI tool to help you manage repositories
- Host: GitHub
- URL: https://github.com/alajmo/mani
- Owner: alajmo
- License: mit
- Created: 2019-10-22T20:05:11.000Z (over 6 years ago)
- Default Branch: main
- Last Pushed: 2026-02-10T00:31:33.000Z (3 months ago)
- Last Synced: 2026-02-10T05:51:22.055Z (3 months ago)
- Topics: cli, git, golang
- Language: Go
- Homepage: https://manicli.com
- Size: 2.47 MB
- Stars: 653
- Watchers: 6
- Forks: 33
- Open Issues: 26
-
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Roadmap: docs/roadmap.md
Awesome Lists containing this project
- awesome-go-extra - mani - 10-22T20:05:11Z|2022-06-19T16:08:34Z| (Utilities / Fail injection)
- awesome-go - mani - CLI tool to help you manage multiple repositories. (Utilities / Utility/Miscellaneous)
- awesome-go - mani - CLI tool to help you manage multiple repositories. (Utilities / Utility/Miscellaneous)
- awesome-go - alajmo/mani
- awesome-go-with-stars - mani - 02-10 | (Utilities / Utility/Miscellaneous)
- awesome-github-repos - alajmo/mani - :robot: CLI tool to help you manage repositories (Go)
- jimsghstars - alajmo/mani - :robot: CLI tool to help you manage repositories (Go)
- awesome-go-cn - mani
- awesome-go - mani - CLI tool to help you manage multiple repositories. (Utilities / Utility/Miscellaneous)
- awesome-go - mani - CLI tool to help you manage multiple repositories. (Utilities / Utility/Miscellaneous)
- awesome-go-info - mani
- awesome-go-cn - mani
- awesome-go - mani - CLI tool to help you manage multiple repositories. (Utilities / Utility/Miscellaneous)
- fucking-awesome-go - mani - CLI tool to help you manage multiple repositories. (Utilities / Utility/Miscellaneous)
- go-awesome-with-star-updatetime - mani - CLI tool to help you manage multiple repositories. (Utilities / HTTP Clients)
- awesome-go-plus - mani - CLI tool to help you manage multiple repositories.  (Utilities / Utility/Miscellaneous)
README
mani
`mani` lets you manage multiple repositories and run commands across them.
Interested in managing your servers in a similar way? Checkout [sake](https://github.com/alajmo/sake)!
## Table of Contents
- [Sponsors](#sponsors)
- [Installation](#installation)
- [Building From Source](#building-from-source)
- [Usage](#usage)
- [Initialize Mani](#initialize-mani)
- [Example Commands](#example-commands)
- [Documentation](#documentation)
- [License](#license)
## Sponsors
Mani is an MIT-licensed open source project with ongoing development. If you'd like to support their efforts, check out [Tabify](https://chromewebstore.google.com/detail/tabify/bokfkclamoepkmhjncgkdldmhfpgfdmo) - a Chrome extension that enhances your browsing experience with powerful window and tab management, focus-improving site blocking, and numerous features to optimize your browser workflow.
## Installation
`mani` is available on Linux and Mac, with partial support for Windows.
Binaries
Download from the [release](https://github.com/alajmo/mani/releases) page.
cURL (Linux & macOS)
```sh
curl -sfL https://raw.githubusercontent.com/alajmo/mani/main/install.sh | sh
```
Homebrew
```sh
brew tap alajmo/mani
brew install mani
```
MacPorts
```sh
sudo port install mani
```
Arch (AUR)
```sh
yay -S mani
```
Nix
```sh
nix-env -iA nixos.mani
```
Go
```sh
go get -u github.com/alajmo/mani
```
Building From Source
1. Clone the repo
2. Build and run the executable
```sh
make build && ./dist/mani
```
Auto-completion is available via `mani completion bash|zsh|fish|powershell` and man page via `mani gen`.
## Usage
### Initialize Mani
Run the following command inside a directory containing your `git` repositories:
```sh
mani init
```
This will generate:
- `mani.yaml`: Contains projects and custom tasks. Any subdirectory that has a `.git` directory will be included (add the flag `--auto-discovery=false` to turn off this feature)
- `.gitignore`: (only when inside a git repo) Includes the projects specified in `mani.yaml` file. To opt out, use `mani init --sync-gitignore=false`.
It can be helpful to initialize the `mani` repository as a git repository so that anyone can easily download the `mani` repository and run `mani sync` to clone all repositories and get the same project setup as you.
### Example Commands
```bash
# List all projects
mani list projects
# Run git status across all projects
mani exec --all git status
# Run git status across all projects in parallel with output in table format
mani exec --all --parallel --output table git status
```
### Documentation
Checkout the following to learn more about mani:
- [Examples](examples)
- [Config](docs/config.md)
- [Commands](docs/commands.md)
- Documentation
- [Filtering Projects](docs/filtering-projects.md)
- [Variables](docs/variables.md)
- [Output](docs/output.md)
- [Changelog](/docs/changelog.md)
- [Roadmap](/docs/roadmap.md)
- [Project Background](docs/project-background.md)
- [Contributing](docs/contributing.md)
## [License](LICENSE)
The MIT License (MIT)
Copyright (c) 2020-2021 Samir Alajmovic