Git-Mod is a powerful CLI supercharger for Git. It wraps complex Git operations into friendly, interactive commands, adds professional features like intelligent identity auto-switching, and saves you from common repository disasters.
Map specific directories to specific Git identities. Git-Mod automatically switches your local user.email and SSH keys the moment you enter a repository. Never accidentally push work code to personal repos again.
Accidentally tracked .env or node_modules? git mod oops adds it to your .gitignore, untracks it, and automatically amends your last commit to erase the evidence.
Write perfect commits every time with git mod commit. A step-by-step wizard guides you through types, scopes, and even adding Co-authored-by credits for your teammates.
Broke your branch? Use git mod rollback to travel back in time, or git mod rescue to browse the reflog and restore lost commits instantly.
The full power of Git-Mod is detailed in our documentation. Dive in to learn more:
- 👤 Identity & Configuration: Profiles, SSH isolation, Magic Auto-Switch, and Smart Init.
- 🛠️ Daily Workflow: Commits, Status Dashboards, Merge/Squash, Stashes, and the Oops Fixer.
- 🚀 Advanced Operations: Rescue, Bisect/Hunt, Checkpoints, Subtrees, Worktrees, and Repo Optimization.
Install Git-Mod globally via npm:
npm install -g git-modpnpm install -g git-modbun install -g git-mod- Initialize your repo:
git mod init
- Setup your identities:
git mod profile add
- Map your Magic Identity (Auto-Switch):
git mod profile # Select "Manage Path Mappings" - Write your first perfect commit:
git mod commit
- Runtime: Node.js
- Language: TypeScript
- Bundler: tsup (esbuild-powered)
- CLI Framework: Commander.js
- Interactions: Inquirer.js
- Git Core: simple-git
This project is licensed under the UnSetSoft Public License (UPL) 1.0. See the LICENSE.md file for details.
Contributions are welcome! Please read our CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.