gitcontrol
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.
O que funciona
- Branches: listar, checkout (local e remota com tracking), merge.
- Commits: log, grafo ASCII, diff completo, cherry-pick.
- Working tree: status, diff de arquivo, stage/unstage por arquivo, commit.
- Remotos: fetch, pull e push (com upstream automático no primeiro push).
- Conflitos: marcar resolvido, abortar e continuar merge/cherry-pick; edição no editor do sistema/TUI.
- Multi-repo: vários repositórios abertos com troca de ativo.
- Refresh automático na TUI (fsnotify + timer) e na GUI (polling curto).
- Instaladores Windows:
.msie.exe(NSIS).
Instalação
PyPI (CLI + TUI)
pip install gitcontrol
gitcontrol --version
gitcontrol
Go
go install github.com/rhyan05/gitcontrol/cmd/gitcontrol@latest
Desktop
Baixe o .msi ou o instalador NSIS na página de releases do GitHub.
Arquitetura
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.
Requisitos
- 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)
TUI / CLI
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 show <hash>
go run ./cmd/gitcontrol --json diff <path>
go run ./cmd/gitcontrol --json remotes
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 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 commit "mensagem"
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: / não se aplica; use tab para trocar de painel, j/k para
mover, enter para checkout/diff, d para diff do arquivo, s/u para
stage/unstage, c para commit, M merge, C cherry-pick, f fetch, p pull,
P push, a abortar conflito, x continuar conflito, e editar arquivo em
conflito e [/] para trocar de repositório.
Desktop
cd desktop
npm install
npm run tauri -- dev
O beforeDevCommand compila o sidecar automaticamente (npm run sidecar) e
inicia o Vite. Para gerar os instaladores:
cd desktop
npm run tauri -- build
Artefatos:
desktop/src-tauri/target/release/bundle/msi/gitcontrol_0.1.1_x64_en-US.msidesktop/src-tauri/target/release/bundle/nsis/gitcontrol_0.1.1_x64-setup.exe
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.
Qualidade
go test ./...
go vet ./...
cd desktop
npm run lint
npm run test
npm run build
cargo check --manifest-path src-tauri/Cargo.toml
Licença
MIT. Veja LICENSE.
Metadata
Release files for gitcontrol 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| gitcontrol-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for gitcontrol-0.1.1-py3-none-any.whl |
Release files / gitcontrol-0.1.1-py3-none-any.whl
| Download URL | gitcontrol-0.1.1-py3-none-any.whl |
|---|---|
| Size | 8.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e2f0acecbbcc68e1a4facd855ca6f3c601d1c5b545ff8f007a264657dc324c8f
|
|
BLAKE2b-256 checksum How to use checksums |
d487630c03c906f5427c154584d786f38fa10ecad31a2d9a673e6bd4979cf4a4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Security for gitcontrol 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.