https://github.com/indigane/visual-git
Open your eyes to Git.
https://github.com/indigane/visual-git
git
Last synced: 4 months ago
JSON representation
Open your eyes to Git.
- Host: GitHub
- URL: https://github.com/indigane/visual-git
- Owner: indigane
- Created: 2024-03-08T13:47:46.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-12-03T14:51:04.000Z (7 months ago)
- Last Synced: 2025-12-06T19:20:54.603Z (7 months ago)
- Topics: git
- Language: JavaScript
- Homepage: https://gitlab.com/indigane/visual-git
- Size: 314 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Visual Git
Visual Git is the Git GUI I've wished existed so I wouldn't have to write it myself.
Some ideas Visual Git may or may not be built on:
- **See everything** you need without polling. Reduce mistakes by being aware of the state of your repository at all times.
- **Interact with everything** you see. You should be allowed to do anything, while staying informed of the consequences of any action.
- **Learn** git. Start from visually intuitive concepts and drill down all the way into git internals if you want to.
## Installation
- Download Visual Git.
_For example:_
```sh
git clone https://gitlab.com/indigane/visual-git.git
```
- [Download node binary](https://nodejs.org/en/download) and place it in `runtime/`. Node 20 recommended.
_For example:_
```sh
cd visual-git
curl -L https://nodejs.org/dist/v20.11.1/node-v20.11.1-linux-x64.tar.xz | tar -Jxv --strip-components=2 -C runtime -f - node-v20.11.1-linux-x64/bin/node
```
- If you want to use a `vg` command, add `visual-git/bin/` to PATH:
_For example temporarily:_
```sh
cd visual-git
export PATH=$PATH:$PWD/bin
```
- Alternatively add `visual-git/bin/vg` as a git alias:
_For example:_
```sh
cd visual-git
git config --global alias.vg '!'$PWD/bin/vg
```
## Usage
- Run `vg` in a git repository.
- Alternatively run `vg `.
## Using with docker
Build container with following command
```
docker build -t visualgit .
```
Start docker with following command in repository directory
```
docker run --rm -i -t -v .:/home/vision/repo -p 3000:3000 visualgit
```