Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/Bhupesh-V/ugit

🚨️ ugit helps undo git commands. Your damage control git buddy. Undo from 20+ git scenarios.
https://github.com/Bhupesh-V/ugit

bash-script fzf-scripts git-toolkit git-tools git-undo git-undo-tool shell-scripts ugit undo-commands undo-git undo-git-command zgenom

Last synced: about 2 months ago
JSON representation

🚨️ ugit helps undo git commands. Your damage control git buddy. Undo from 20+ git scenarios.

Host: GitHub
URL: https://github.com/Bhupesh-V/ugit
Owner: Bhupesh-V
License: mit
Created: 2021-04-10T06:18:47.000Z (over 3 years ago)
Default Branch: master
Last Pushed: 2024-02-07T09:12:34.000Z (11 months ago)
Last Synced: 2024-04-13T21:57:44.614Z (8 months ago)
Topics: bash-script, fzf-scripts, git-toolkit, git-tools, git-undo, git-undo-tool, shell-scripts, ugit, undo-commands, undo-git, undo-git-command, zgenom
Language: Shell
Homepage: https://bhupesh.me/undo-your-last-git-mistake-with-ugit/
Size: 179 KB
Stars: 1,340
Watchers: 10
Forks: 44
Open Issues: 7
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome - Bhupesh-V/ugit - 🚨️ ugit helps undo git commands. Your damage control git buddy. Undo from 20+ git scenarios. (Shell)

README

        
ugit





Undo your last oopsie 🙈️ in git



  

    

  

  

    

  

  

  

    

  

  

    

  

  

    

  



  




More Video Demos ✨️

Undo git add



https://user-images.githubusercontent.com/34342551/121651365-29dbdc80-cab8-11eb-8c43-6d0c4b1509ad.mp4

Undo git branch -D



https://user-images.githubusercontent.com/34342551/121650985-c487eb80-cab7-11eb-9b6a-9257fa704d1c.mp4

Undo git merge



https://user-images.githubusercontent.com/34342551/121651071-d9fd1580-cab7-11eb-929d-d9359a64f0eb.mp4



## Why use `ugit`?

- You accidentally ran a `git` command you wish to 'undo'.

- You want to save time by not searching for _how to undo ..._

- Your focus is on the problems at hand and not on Git (avoid context switching)

### [Motivations behind writing ugit 🙇‍♂️️](https://bhupesh-v.github.io/undo-your-last-git-mistake-with-ugit)

## What's in the box?

`ugit`/`git-undo` supports undoing the following operations, some are a WIP. If you know of any other operations that can be undone and are not in the list, make sure to raise an issue or make a quick PR 💛️

- [x] Undo `git commit`

- [x] Undo `git add`

- [x] Undo `git push`

- [x] Undo `git branch -D` (branch delete)

- [x] Undo `git pull`

- [x] Undo `git reset`

- [x] Undo `git tag -d` (tag delete)

- [x] Undo `git stash apply`

- [x] Undo `git stash pop/drop/clear`

- [x] Undo accidental file delete (Restore a deleted file after a commit)

- [x] Undo (Restore) a file to a previous version

- [x] Undo `git merge`

- [x] Undo `git cherry-pick`

- [x] Undo `git tag`

- [ ] Undo `git rebase`

- [ ] Undo `git worktree remove` (recover deleted work-tree)

Contribute to the project by helping me with the above-mentioned tasks.

If you have any other ideas/suggestions, do send them across. [**Hop in to ugit discussions 💬️**](https://github.com/Bhupesh-V/ugit/discussions/7)

## News

|      When      |                                                                                  What                                                                                 |

|:--------------:|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------|

|  29 Oct, 2022 |  ugit crossed 1k stars                                               |

|  02 June, 2022 | [console.dev](https://console.dev/tools/) featured [ugit](https://twitter.com/bhupeshimself/status/1532714651842396161)                                               |

|  18 May, 2022  | I gave a talk about the git tooling ecosystem & `git undo` in [Undo git, say whaat! - **GitHub India Constellation**, May 2022](https://youtu.be/jpR9BMFmh4Y?t=15240) |

|  12 May, 2021  | The [guide was **tweeted by GitHub**](https://twitter.com/github/status/1392207961355862018?s=20) (I was logging my research process there while building ugit)       |

| 30 April, 2021 | Featured on [**Changelog News**](https://changelog.com/news/ugit-helps-you-undo-your-last-git-command-with-grace-8X6L)                                                |

## Community

- Alexander Alemayhu made a YouTube tutorial on [Undoing Your Last Git Commit with Ugit](https://www.youtube.com/watch?v=nUnCgKb4tSc)

## Installation

[Try `ugit` via Docker](https://hub.docker.com/r/bhupeshimself/ugit):

```bash

docker pull bhupeshimself/ugit

docker run --rm -it -v $(pwd):/app bhupeshimself/ugit

```

### Prerequisites

**ugit** dependencies:

- **Bash** >= `4.x.x`

- **Git** >= `2.23.0`

- [**fzf**](https://github.com/junegunn/fzf) >= `0.21.0` - [Installation guide](https://github.com/junegunn/fzf#installation)

- GNU utils like `awk`, `grep`, `tput` etc




[![Packaging status](https://repology.org/badge/vertical-allrepos/ugit.svg)](https://repology.org/project/ugit/versions)

### Linux

```bash

sh -c "$(curl -fsSL https://raw.githubusercontent.com/Bhupesh-V/ugit/master/install)"

```

Arch Linux users can install [**ugit via AUR**](https://aur.archlinux.org/packages/ugit).

### Mac

```bash

brew install ugit

```

### Windows

To use ugit on Windows you need to install:

1. Git Bash


   Git bash comes with git (if you have installed it on your machine then no need). To install git (preferably with scoop):

    ```

    scoop install git

    ```

2. FZF 

   ```

   scoop install fzf

   ```

   Alternatively, with Chocolatey:

   

   ```

   choco install fzf

   ```

3. To use bash in terminal change your directory to `**git\2.35.3.windows.1\bin\bash**` accordingly.

4. Then either clone the repo,

   ```bash

   git clone https://github.com/Bhupesh-V/ugit.git

   ```

   or get it using curl:

   ```bash

   sh -c "$(curl -fsSL https://raw.githubusercontent.com/Bhupesh-V/ugit/master/install)"

   ```

### Fig

[Fig](https://fig.io) adds apps, shortcuts, and autocomplete to your existing terminal.

Install `ugit` in just one click.



### ZSH Frameworks

#### Zgenom

If you're using [Zgenom](https://github.com/jandamm/zgenom):

1. Add `zgenom load Bhupesh-V/ugit` to your `.zshrc` along with your other `zgenom load` commands.

2. `zgenom reset && zgenom save`

#### Antigen

If you're using [Antigen](https://github.com/zsh-users/antigen):

1. Add `antigen bundle Bhupesh-V/ugit` to your `.zshrc` where you've listed your other plugins.

2. Close and reopen your Terminal/iTerm window to **refresh context** and use the plugin. Alternatively, you can run `antigen bundle Bhupesh-V/ugit` in a running shell to have `antigen` load the new plugin.

#### Oh-My-ZSH

If you're using [oh-my-zsh](github.com/robbyrussell/oh-my-zsh):

1. Clone the repository into a new `ugit` directory in oh-my-zsh's plugin folder:

    `git clone https://github.com/Bhupesh-V/ugit.git $ZSH_CUSTOM/plugins/ugit`

2. Edit your `~/.zshrc` and add `ugit` – same as clone directory – to the list of plugins to enable:

    `plugins=( ... ugit )`

3. Then, restart your terminal application to **refresh context** and use the plugin. Alternatively, you can source your current shell configuration:

    `source ~/.zshrc`

## Please read ⚠️

Git comes with a garbage collector ([in case you didn't know](https://git-scm.com/docs/git-gc)) therefore undoing some commands will become impossible if the entries are deleted from the reflog.

One way to prevent this is to increase default time limits before the reflog entries expire.

Add these configurations in your global `.gitconfig` file:

```gitconfig

[gc]

    # default 90 days

    reflogExpire = 200

```

Used to set how long records in a branch reflog should be preserved.

```gitconfig

[gc]

    # default 30 days

    reflogExpireUnreachable = 90

```

Used to set how long inaccessible reflog records should be preserved.

## Not satisfied? 😒️

You can read my in-process guide on [**How to undo anything in Git**](https://bhupesh.gitbook.io/notes/git/how-to-undo-anything-in-git)

## Credit & Thanks

To all the SO threads that I will probably never visit again ;)

## ☺️ Show your support

Support me by giving a ⭐️ if this project helped you! or just [![Twitter URL](https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2FBhupesh-V%2Fugit%2F)](https://twitter.com/intent/tweet?url=https://github.com/Bhupesh-V/ugit&text=ugit%20via%20@bhupeshimself)

[![Support via PayPal](https://cdn.rawgit.com/twolfson/paypal-github-button/1.0.0/dist/button.svg)](https://www.paypal.me/BhupeshVarshney/)

## 📝 License

Copyright © 2021 [Bhupesh Varshney](https://github.com/Bhupesh-V).


This project is [MIT](https://github.com/Bhupesh-V/ugit/blob/master/LICENSE) licensed.

## 👋 Contributing

Please read the [CONTRIBUTING](CONTRIBUTING.md) file for the process of submitting pull requests to us.

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

  

    

      
_{Sharan Aithal}
💻 📖

      
_Tabulate
💻 📦

      
_{Joe Block}
💻 📖 🔌

      
_{César Román}
💻 🐛

      
_{Ilkin Bayramli}
📦

      
_{Kopal Chakravarty}
💻

      
_{Zorawar Purohit}
📖

    

    

      
_{Nalin Singh}
💻

      
_vinayaknayar
📖

      
_{RohitSingh107}
📦

      
_{Théotime Maillarbaux}
💻 🐛

      
_dr41d45
💻

      
_{Taebok Joseph Kim}
💻

    

  

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!