README.md

gadd

Command-line utility for staging changes to Git (alternative to git-add's interactive mode). Written in Rust, using git2-rs to interact with Git, and ratatui for the terminal UI.

Screenshots

The Git staging area in gadd:

Installation

Through Cargo (Rust package manager)

• Run cargo install gadd
• You should now be able to type gadd inside a Git repo in the terminal to manage your changes!

Manually

• Go to the Releases page
• Download the appropriate binary for your OS and architecture under Assets
  • On Linux/MacOS: Save the file as gadd
  • On Windows: Save the file as gadd.exe
• Update your PATH environment variable to include the folder where you saved gadd
  • On Linux/MacOS:
    • Using zsh: echo 'export PATH=${HOME}/bin:${PATH}' >> ~/.zshrc
    • Using Bash: echo 'export PATH=${HOME}/bin:${PATH}' >> ~/.bashrc
    • These examples assume you saved gadd in ${HOME}/bin - replace it with your own path if you saved it somewhere else
  • On Windows:
    • Use the Windows search bar to search for "Edit environment variables", and open the suggested control panel
    • Under "User variables for [user]", find the one called "Path", and click "Edit..."
    • Click "New", and enter the path to the folder where you saved gadd.exe
• Restart your terminal
• You should now be able to type gadd inside a Git repo in the terminal to manage your changes!

Credits

• Git logo adapted from Jason Long (licensed under CC BY 3.0)