Microplane
| Project Name | Stars | Downloads | Repos Using This | Packages Using This | Most Recent Commit | Total Releases | Latest Release | Open Issues | License | Language |
|---|---|---|---|---|---|---|---|---|---|---|
| Bat | 41,520 |  | 1 | 35 | a day ago | 37 | September 10, 2022 | 210 | apache-2.0 | Rust |
| A cat(1) clone with wings. | ||||||||||
| Lazygit | 35,496 | 2 | 7 hours ago | 209 | July 18, 2022 | 498 | mit | Go | ||
| simple terminal UI for git commands | ||||||||||
| Cli | 32,491 | 27 | 4 hours ago | 152 | September 21, 2022 | 426 | mit | Go | ||
| GitHub’s official command line tool | ||||||||||
| Learngitbranching | 27,578 | 16 days ago | 1 | May 29, 2019 | 24 | mit | JavaScript | |||
| An interactive git visualization and tutorial. Aspiring students of git can use this app to educate and challenge themselves towards mastery of git! | ||||||||||
| Vim Fugitive | 17,651 | 5 days ago | 35 | Vim Script | ||||||
| fugitive.vim: A Git wrapper so awesome, it should be illegal | ||||||||||
| Cz Cli | 15,257 |  | 13,219 | 13,625 | 2 days ago | 78 | May 07, 2021 | 179 | mit | JavaScript |
| The commitizen command line utility. #BlackLivesMatter | ||||||||||
| Dolt | 14,931 | 2 | an hour ago | 214 | May 19, 2022 | 292 | apache-2.0 | Go | ||
| Dolt – Git for Data | ||||||||||
| Git History | 13,254 | 2 months ago | 7 | March 19, 2019 | 76 | mit | JavaScript | |||
| Quickly browse the history of a file from any git repository | ||||||||||
| Onefetch | 7,865 | 10 hours ago | 29 | March 29, 2022 | 25 | mit | Rust | |||
| Command-line Git information tool | ||||||||||
| Gitsome | 7,392 | 8 | 2 months ago | 12 | April 07, 2019 | 60 | other | Python | ||
| A supercharged Git/GitHub command line interface (CLI). An official integration for GitHub and GitHub Enterprise: https://github.com/works-with/category/desktop-tools | ||||||||||
microplane
A CLI tool to make git changes across many repos.
Learn more about microplane in this introductory blogpost.
"the lemon is Git{Hub,Lab}"
Setup
Here are several ways to install microplane:
- Pre-built release - You can download a pre-built version of Microplane from the Github releases.
-
Compile it yourself - Run
go install github.com/Clever/[email protected]. In this case the binary will be installed to$GOPATH/bin/microplane. Alternately, you can follow the steps under "Development", below. -
Homebrew -
brew install microplane. The latest homebrew formula is here
Usage
GitHub setup
The GITHUB_API_TOKEN environment variable must be set for Github. This should be a GitHub Token with repo scope.
Optional: If you use self-hosted Github, you can specify its URL by passing --provider-url=<your URL> when running mp init.
This URL should look like: https://[hostname]. Don't include path parameters like /api/v3 or /api/uploads.
Self-hosted Github setup with different URLs for the main API and uploads API are not yet supported. If this is a blocker for you, please file an issue or make a PR.
GitLab setup
The GITLAB_API_TOKEN environment variable must be set for Gitlab. This should be a GitLab access token
To use Gitlab, you must specifically pass --provider=gitlab when running mp init.
Optional: If you use a self-hosted Gitlab, you can specify its URL by passing --provider-url=<your URL> when running mp init.
Using Microplane
Microplane has an opinionated workflow for how you should manage git changes across many repos. To make a change, use the following series of commands.
- Init - target the repos you want to change
- Clone - clone the repos you just targeted
- Plan - run a script against each of the repos and preview the diff
- Push - commit, push, and open a Pull Request
- Merge - merge the PRs
For an in-depth example, check out the introductory blogpost.
Related projects
Development
See Development.md.
