Stop typing the same five Git commands. Run one instead.
If GitGo saves you time, consider buying me a coffee. It helps keep the project going.
GitGo wraps your most-typed git commands into shorter ones. It covers init, add, commit, push, branch, and stash. It also includes features most wrappers leave out: SSH key setup, HTTPS-to-SSH conversion, and a named stash interface called state management.
# Instead of this:
git init && git add . && git commit -m "init" && git remote add origin <url> && git push -u origin main
# Run this:
gitgo link https://github.com/username/repo.git "init"- Demo
- Features
- Installation Guide
- Usage
- Command Reference
- How It Works
- Contributing
- Credits
- License
- Changelog
- Contributing Guide
- Single commands for linking, pushing, and stashing. No more chaining five commands together.
- Undo: Roll back commits, unstage files, or discard local changes. The subcommands say what they do:
undo commit,undo add,undo changes. - Branch switching with
jump: Stashes your uncommitted work, moves to the target branch, syncs with main, and pops the stash. If a merge conflict occurs, the Try-and-Revert engine offers to roll the whole operation back. - State management: Named, indexed stash. Run
state listto see what you saved. No morestash@{2}archaeology. - Custom defaults: Store your preferred branch name and default commit message. GitGo picks them up on every run.
- Auto-update checker: Checks PyPI for newer versions in a background thread. Results are cached for 7 days so startup isn't delayed.
- SSH auto-setup & signing: Generates an
ed25519key, loads it intossh-agent, opens your GitHub SSH settings page, and automatically signs all future commits for the verified badge. - HTTPS-to-SSH conversion: Detects HTTPS remotes and rewrites them before pushing if SSH is configured. No manual
git remote set-url. - Termux support: Detects the Termux environment, adjusts install paths, uses
termux-openfor browser actions, and patches the dubious ownership Git error.
- Python 3.8+
- Git 2.x+: git-scm.com
- OpenSSH: required for
gitgo user login(pre-installed on most systems) - A GitHub account
For Windows users or environments without global pip restrictions:
pip install pygitgo(Alternatively, use pipx install pygitgo for an isolated environment.)
pipx install pygitgoThe install script creates an isolated environment and places gitgo in ~/.local/bin. Useful for PEP 668-enforced systems:
curl -sSL https://raw.githubusercontent.com/Huerte/GitGo/main/install.sh | bashVerify the installation:
gitgo -rNote for Termux (Android): GitGo detects the Termux environment automatically and adjusts install paths and browser behavior accordingly.
git clone https://github.com/Huerte/GitGo.git
cd GitGo
pip install -e .Run this once on a new machine. GitGo generates an SSH key, adds it to ssh-agent, prints the public key, and opens your GitHub SSH settings page so you can add it for both authentication and commit signing.
gitgo user loginPoint GitGo at an existing empty GitHub repo. It initializes Git, stages everything, commits, and pushes — including pulling unrelated histories if the remote isn't empty.
gitgo link https://github.com/username/repo.git "Initial commit"# Push to an existing branch
gitgo push main "Fix auth bug"
# Create a new branch and push
gitgo push -n feat/login "Add login flow"Switch branches with uncommitted work in progress. jump stashes your changes, moves to the target branch, syncs with main, and pops the stash. If the pop triggers a conflict, it offers to abort and restore the repo to its prior state.
gitgo jump feat/new-loginUndo recent mistakes with commands named for what they undo.
gitgo undo commit # Undo the last commit (files stay staged)
gitgo undo add # Unstage files
gitgo undo changes # DANGER: permanently discard all uncommitted editsgitgo state save "halfway through refactor"
gitgo state list
gitgo state load 1gitgo config set default-branch develop
gitgo config set default-message "WIP: updates"
gitgo config get default-branchStage, commit, and push in one command.
gitgo push [branch] [message]
gitgo push -n [branch] [message] # create new branch first
gitgo push -s [branch] [message] # interactively select files to stageTip
Use gitgo push -h to see all available flags and examples.
| Flag | Description |
|---|---|
-n, --new |
Create a new branch before pushing |
-s, --select |
Interactively select which files to include in the push |
If there are no new changes but unpushed commits exist, GitGo detects this and pushes without creating an empty commit.
Pulls updates from the remote. Stashes any uncommitted work first, runs a rebase pull, then pops the stash.
gitgo pull # Pull updates for the current branch
gitgo pull <branch> # Pull updates from a specific branchInitializes a Git repository, connects it to a remote, and pushes. Works on already-initialized repos and handles unrelated histories.
gitgo link <github_repo_url> [commit_message]Switches branches with uncommitted work in progress. Stashes changes, moves to the target branch, pulls from main, and pops the stash. If the pop triggers a merge conflict, the Try-and-Revert engine offers to abort the entire operation and restore the repo to the state it was in before the command ran.
gitgo jump <branch>Undo recent actions with subcommands named for what they undo.
gitgo undo commit # Undo the last commit without losing files
gitgo undo add # Unstage files
gitgo undo changes # Permanently discard all new files and uncommitted editsNamed, indexed interface over git stash.
gitgo state list # show all saved states
gitgo state save [name] # save current work (default name: Auto-Save)
gitgo state load [id] # restore a state by index
gitgo state delete [id] # delete a state by index
gitgo state delete -a # delete all saved statesShort aliases: -l, -s, -o, -d
gitgo user # show current Git identity
gitgo user login # generate SSH key and configure Git identity
gitgo user logout # remove SSH keys and Git identity configManage your GitGo defaults.
gitgo config set <key> <value>
gitgo config get <key>| Key | Description | Default |
|---|---|---|
default-branch |
The branch used for push/link | main |
default-message |
The commit message used for push | New Project Update |
gitgo help # show complete manual
gitgo <cmd> -h # show help for a specific command
gitgo -v # version
gitgo -r # verify GitGo is ready- SSH Auto-Setup & Signing:
gitgo user logingenerates aned25519SSH key and prompts you to add it to GitHub twice (for authentication and signing). GitGo then injects temporary-cflags into every commit to automatically sign them with this key, without touching your global git config. - HTTPS to SSH Conversion: If your remote is set to HTTPS and SSH is configured, GitGo rewrites the remote before pushing. No
git remote set-urlrequired. - Auto-Update Checker: Spawns a non-blocking background thread on startup to query PyPI for newer versions. Results are cached locally for 7 days to prevent unnecessary network requests.
- Termux Compatibility: Detects Termux via environment variables, adjusts binary locations (
$PREFIX/bin), usestermux-openfor browser actions, and patches thedetected dubious ownershipGit error. - State Management:
gitgo statewrapsgit stashwith named saves, indexed listing, and confirmation prompts.
Contributions are welcome. Read CONTRIBUTING.md for the full guide, including project structure, test instructions, commit conventions, and a Good First Issues table if you're not sure where to start.
 Huerte Creator |
 Venomous-pie Contributor |
Distributed under the GPLv3 License. See LICENSE for details.