Gerenciador de Git com três interfaces sobre o mesmo core:
- TUI em Go/Bubble Tea para operar tudo pelo terminal.
- CLI JSON (
gitcontrol --json) com contrato estável para automação. - Desktop em Tauri + React para uma experiência visual.
Capturas geradas com um repositório de demonstração.
$ gitcontrol --json status
{"ok":true,"data":{"branch":"main","head_oid":"2b1a0ce...","files":[]}}- Demo em 48s — TUI, desktop e CLI em menos de um minuto.
- Tour completo — 2 minutos, com capítulos.
- Branches: listar, criar, deletar, renomear, checkout (local e remota com tracking), merge e rebase.
- Commits: log, grafo ASCII, diff completo, cherry-pick e amend.
- Working tree: status, diff de arquivo, stage/unstage, discard e commit.
- Remotos: listar, adicionar, remover, fetch, pull e push (com upstream automático no primeiro push).
- Stash: guardar, listar, aplicar, pop e drop.
- Tags: listar, criar (leve ou anotada) e deletar.
- Conflitos: marcar resolvido, abortar e continuar merge/cherry-pick/rebase; edição no editor do sistema/TUI.
- Reset: soft, mixed e hard.
- Multi-repo: vários repositórios abertos com troca de ativo.
- Refresh automático na TUI (fsnotify + timer) e na GUI (polling curto).
- Desktops: Windows (
.msi/NSIS), Linux (.AppImage/.deb) e macOS (.dmg).
pip install gitcontrol
gitcontrol --version
gitcontrolgo install github.com/rhyan05/gitcontrol/cmd/gitcontrol@latestBaixe o artefato da sua plataforma na página de releases:
- Windows:
.msiou instalador NSIS. - Linux:
.AppImageou.deb(x86_64). - macOS:
.dmg(Apple Silicon).
Linux (AppImage):
chmod +x gitcontrol_*.AppImage
./gitcontrol_*.AppImageSe o AppImage reclamar de FUSE:
sudo apt install libfuse2
# ou rode sem FUSE:
./gitcontrol_*.AppImage --appimage-extract-and-runLinux (Debian/Ubuntu):
sudo apt install ./gitcontrol_*.debmacOS: abra o .dmg, arraste o app para Applications e use botão direito →
Abrir na primeira execução. Se o Gatekeeper bloquear:
xattr -dr com.apple.quarantine /Applications/gitcontrol.app
open /Applications/gitcontrol.appWindows: se o SmartScreen avisar, clique em Mais informações → Executar assim mesmo. Os builds não são assinados/notarizados; esse aviso é esperado.
cmd/gitcontrol/ entrada única: TUI, --json ou --version
internal/git/ core Go (status, log, grafo, remotes, conflitos, ações)
internal/cli/ contrato JSON (envelope ok/data ou ok/error)
packaging/pypi/ wheel universal com os binários Go embutidos
desktop/ app Tauri + React + Tailwind v4
src/ UI (componentes, features, hooks, sidecar client)
src-tauri/ runtime Rust, sidecar e ícones
O desktop não reimplementa Git: ele chama o sidecar gitcontrol --json, que é
o mesmo binário do core testado em Go.
- Go 1.27+
- Node.js 22+ e npm
- Rust 1.90+ com toolchain MSVC
- Visual Studio Build Tools com Desktop development with C++
- WebView2 Runtime (Windows)
go test ./...
go run ./cmd/gitcontrol # abre a TUI
go run ./cmd/gitcontrol --version
go run ./cmd/gitcontrol --json --repo . status
go run ./cmd/gitcontrol --json log
go run ./cmd/gitcontrol --json graph
go run ./cmd/gitcontrol --json branches
go run ./cmd/gitcontrol --json branch-create <name> [start]
go run ./cmd/gitcontrol --json branch-delete <name> [--force]
go run ./cmd/gitcontrol --json branch-rename <old> <new>
go run ./cmd/gitcontrol --json show <hash>
go run ./cmd/gitcontrol --json diff <path>
go run ./cmd/gitcontrol --json remotes
go run ./cmd/gitcontrol --json remote-add <name> <url>
go run ./cmd/gitcontrol --json remote-remove <name>
go run ./cmd/gitcontrol --json fetch [remote]
go run ./cmd/gitcontrol --json pull [remote] [branch]
go run ./cmd/gitcontrol --json push [remote] [branch]
go run ./cmd/gitcontrol --json checkout <branch>
go run ./cmd/gitcontrol --json merge <branch>
go run ./cmd/gitcontrol --json cherry-pick <hash>
go run ./cmd/gitcontrol --json rebase <upstream>
go run ./cmd/gitcontrol --json resolve <path...>
go run ./cmd/gitcontrol --json abort
go run ./cmd/gitcontrol --json continue
go run ./cmd/gitcontrol --json stage <path...>
go run ./cmd/gitcontrol --json unstage <path...>
go run ./cmd/gitcontrol --json discard <path...>
go run ./cmd/gitcontrol --json commit "mensagem"
go run ./cmd/gitcontrol --json amend ["mensagem"]
go run ./cmd/gitcontrol --json reset <rev> [soft|mixed|hard]
go run ./cmd/gitcontrol --json stash [--untracked] [mensagem]
go run ./cmd/gitcontrol --json stash-list
go run ./cmd/gitcontrol --json stash-pop [index]
go run ./cmd/gitcontrol --json stash-apply [index]
go run ./cmd/gitcontrol --json stash-drop [index]
go run ./cmd/gitcontrol --json tags
go run ./cmd/gitcontrol --json tag-create <name> [mensagem]
go run ./cmd/gitcontrol --json tag-delete <name>O contrato é sempre um objeto JSON:
{"ok":true,"data":{...}}
{"ok":false,"error":{"code":"git_error","message":"..."}}Exit code 0 em sucesso e 1 em erro.
Teclas da TUI: tab troca de painel, j/k move, enter faz checkout/diff,
d abre o diff do arquivo, s/u faz stage/unstage, c commit, M merge,
C cherry-pick, f fetch, p pull, P push, a abortar conflito, x
continuar conflito, e editar arquivo em conflito, n nova branch, R
renomear, D deletar branch, r rebase, z stash, Z stash pop, t tag,
A amend, X discard e [/] para trocar de repositório. A TUI lembra os
repositórios e o ativo em ~/.config/gitcontrol/workspace.json
(%AppData%\gitcontrol no Windows).
cd desktop
npm install
npm run tauri -- devO beforeDevCommand compila o sidecar automaticamente (npm run sidecar) e
inicia o Vite. Para gerar os instaladores:
cd desktop
npm run tauri -- buildArtefatos:
- Windows:
desktop/src-tauri/target/release/bundle/msi/*.msie.../bundle/nsis/*.exe - Linux:
.../bundle/appimage/*.AppImagee.../bundle/deb/*.deb - macOS:
.../bundle/dmg/*.dmg
Atalhos da GUI: / busca, r atualiza, Ctrl/Cmd+K abre a paleta de comandos,
Esc fecha diálogos. O painel de diff é redimensionável pela alça acima dele.
go test ./...
go vet ./...
cd desktop
npm run lint
npm run test
npm run build
cargo check --manifest-path src-tauri/Cargo.tomlMIT. Veja LICENSE.




