#git #staging #interactive #tui #command-line-tool #utility #ui

app gadd

Command-line utility for staging changes to Git (alternative to git-add's interactive mode)

5 releases (breaking)

0.5.0 Mar 17, 2024
0.4.0 Mar 17, 2024
0.3.0 Jun 10, 2023
0.2.0 May 21, 2023
0.1.0 Apr 20, 2023

#2696 in Command line utilities

Download history 22/week @ 2024-07-27 6/week @ 2024-09-21

116 downloads per month

MIT license

69KB
1.5K SLoC

Ferris the Crab, mascot of the Rust programming language, holding Git logo

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:

Screenshot of the gadd terminal application

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

Dependencies

~17–30MB
~513K SLoC