https://github.com/drzioner/gitwise
Python CLI for optimized Git workflows and coding agents integration.
https://github.com/drzioner/gitwise
ai ai-agents automation claude-code cli developer-tools git git-workflows github gpg opencode python
Last synced: 6 days ago
JSON representation
Python CLI for optimized Git workflows and coding agents integration.
- Host: GitHub
- URL: https://github.com/drzioner/gitwise
- Owner: drzioner
- License: mit
- Created: 2026-05-15T14:10:42.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-13T00:01:50.000Z (11 days ago)
- Last Synced: 2026-06-13T01:20:38.781Z (11 days ago)
- Topics: ai, ai-agents, automation, claude-code, cli, developer-tools, git, git-workflows, github, gpg, opencode, python
- Language: Python
- Homepage:
- Size: 709 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.es.md
- Changelog: CHANGELOG.es.md
- Contributing: CONTRIBUTING.es.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.es.md
- Roadmap: ROADMAP.es.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# gitwise
Source: README.md
Last sync: 2026-05-22
[English](README.md) | [Español](README.es.md)
CLI de Python para optimizar flujos de Git e integración con agentes de código.
[](https://github.com/drzioner/gitwise/actions/workflows/ci.yml)
[](https://codecov.io/gh/drzioner/gitwise)
[](https://github.com/drzioner/gitwise/releases)
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](docs/es/README.md)
gitwise resuelve tres problemas comunes:
1. Contexto excesivo para AI por usar `git diff` crudo
2. Repos lentos sin configuraciones modernas de mantenimiento de Git
3. Flujos de commit inseguros que evaden las reglas de GPG
## Requisitos
- Python >= 3.10
- git >= 2.29
- macOS o Linux
## Instalación
```bash
git clone https://github.com/drzioner/gitwise.git ~/.local/share/gitwise
bash ~/.local/share/gitwise/install.sh
```
Actualizar una instalación existente:
```bash
gitwise update
```
## Inicio rápido
```bash
gitwise doctor
gitwise setup --dry-run
gitwise setup-agents --local --dry-run
gitwise summarize
```
## Comandos más usados
| Comando | Propósito |
|---|---|
| `gitwise doctor` | Verifica Python, git, plataforma y herramientas opcionales |
| `gitwise setup` | Aplica defaults modernos de Git de forma segura |
| `gitwise setup-agents` | Instala layout canónico de agentes + configuración opcional de providers |
| `gitwise audit` | Detecta ramas stale, gaps de graph/cache, blobs grandes |
| `gitwise summarize` | Contexto compacto para humanos y agentes |
| `gitwise diff` | Vista enfocada de cambios (`--stat`, `--staged`, `--patch`) |
| `gitwise worktree` | Crea y limpia flujos por worktree |
| `gitwise status` | Status mejorado con staged/unstaged y ahead/behind |
| `gitwise commands --json` | Lista subcomandos con aliases y metadata |
| `gitwise schema --json` | Retorna JSON Schema versionado para inputs de comandos |
| `gitwise completions ` | Genera scripts de completions (bash/zsh/fish) |
| `gitwise pr` | Lista/check/view de PRs con GitHub CLI |
Para todos los comandos, ejemplos, aliases y uso JSON:
- [Command reference (English)](docs/reference/commands.md)
- [Referencia de comandos (Español)](docs/es/reference/commands.md)
## Documentación
- [Documentation index (English)](docs/README.md)
- [Índice de documentación (Español)](docs/es/README.md)
- [Contributing guide](CONTRIBUTING.md)
- [Guía de contribución](CONTRIBUTING.es.md)
- [Security policy](SECURITY.md)
- [Política de seguridad](SECURITY.es.md)
- [Code of Conduct](CODE_OF_CONDUCT.md)
- [Código de conducta](CODE_OF_CONDUCT.es.md)
- [Git conventions](CONVENTIONS.md)
- [Convenciones Git](CONVENTIONS.es.md)
## Modelo de seguridad y GPG
`setup` y `setup-agents` nunca modifican `commit.gpgsign` ni `user.signingkey`.
- Capa Git: `setup` gestiona hooks de forma segura (`--hooks-mode preserve|native|legacy|skip`) para validar disponibilidad de la clave y conventional commits.
- Capa agente: deny-rules bloquean `--no-gpg-sign`, `--no-verify` y `-c commit.gpgsign=false`.
## Variables de entorno
| Variable | Descripción |
|---|---|
| `GITWISE_DEBUG=1` | Muestra cada comando `git` ejecutado por subprocess en stderr |
| `GITWISE_LOG_JSON=1` | Emite logs estructurados en stderr como líneas JSON |
| `GITWISE_JSON_PRETTY=1` | Formatea JSON en modo pretty por defecto |
| `GITWISE_LANG=es` / `GITWISE_LANG=en` | Fuerza el locale de salida |
| `GITWISE_THEME=dark` / `GITWISE_THEME=light` / `GITWISE_THEME=auto` | Fuerza selección de tema de color |
| `GITWISE_NO_COLOR=1` | Desactiva salida ANSI con color |
| `GITWISE_OUTPUT=agent` | Fuerza modo de salida orientado a máquina |
| `GITWISE_AGENT=1` | Alias para habilitar modo agent |
| `GITWISE_GIT_TIMEOUT=` | Override del timeout de subprocess git |
| `GITWISE_WIDTH=` | Override del ancho de salida |
| `GITWISE_BIN_DIR` | Directorio de instalación (default: `~/.local/bin`) |
## Completions de shell
Genera script de completions por shell:
```bash
gitwise completions bash > ~/.local/share/bash-completion/completions/gitwise
gitwise completions zsh > ~/.zsh/completions/_gitwise
gitwise completions fish > ~/.config/fish/completions/gitwise.fish
```
## Demo
[](https://asciinema.org/a/6tm4TnYMygEQT7ef)
## Licencia
[MIT](LICENSE) - Deiner