gitwise

English | Español

Python CLI for optimized Git workflows and coding agents integration.

gitwise addresses three daily pain points:

1. AI context bloat from raw git diff
2. Slow repositories without modern Git maintenance settings
3. Unsafe commit flows that bypass GPG signing rules

Requirements

• Python >= 3.10
• git >= 2.29
• macOS or Linux

Install

git clone https://github.com/drzioner/gitwise.git ~/.local/share/gitwise
bash ~/.local/share/gitwise/install.sh

Update an existing installation:

gitwise update

Quick Start

gitwise doctor
gitwise setup --dry-run
gitwise setup-agents --local --dry-run
gitwise summarize

Most Used Commands

Command	Purpose
gitwise doctor	Check Python, git, platform, optional tools
gitwise setup	Apply modern Git defaults safely
gitwise setup-agents	Install canonical agents layout + optional provider config
gitwise audit	Detect stale branches, graph/cache gaps, large blobs
gitwise summarize	Compact context for humans and AI
gitwise diff	Focused changed-file view (--stat, --staged, --patch)
gitwise worktree	Create and clean worktree-based branch setups
gitwise status	Enhanced status with staged/unstaged and ahead/behind
gitwise commands --json	List subcommands with aliases and metadata
gitwise schema <command> --json	Return versioned JSON Schema for command inputs
gitwise completions <shell>	Generate shell completion scripts (bash/zsh/fish)
gitwise pr	List/check/view PRs via GitHub CLI

For all commands, examples, aliases, and JSON usage, see:

• Command reference (English)
• Referencia de comandos (Español)

Documentation

• Documentation index (English)
• Indice de documentacion (Español)
• Contributing guide
• Guia de contribucion
• Security policy
• Politica de seguridad
• Code of Conduct
• Código de conducta
• Git conventions
• Convenciones Git

GPG and Safety Model

setup and setup-agents never modify commit.gpgsign or user.signingkey.

• Git layer: setup manages hooks safely (--hooks-mode preserve|native|legacy|skip) to validate signing key availability and conventional commits.
• Agent layer: deny-rules block --no-gpg-sign, --no-verify, and -c commit.gpgsign=false.

Environment Variables

Variable	Description
GITWISE_DEBUG=1	Print each git subprocess command to stderr
GITWISE_LOG_JSON=1	Emit structured stderr logs as JSON lines
GITWISE_JSON_PRETTY=1	Pretty-print JSON output by default
GITWISE_LANG=es / GITWISE_LANG=en	Force output locale
GITWISE_THEME=dark / GITWISE_THEME=light / GITWISE_THEME=auto	Override color theme selection
GITWISE_NO_COLOR=1	Disable ANSI color output
GITWISE_OUTPUT=agent	Force machine-oriented output mode
GITWISE_AGENT=1	Alias to enable agent output mode
GITWISE_GIT_TIMEOUT=<seconds>	Override git subprocess timeout
GITWISE_WIDTH=<columns>	Override output width
GITWISE_BIN_DIR	Install location (default: ~/.local/bin)

Shell Completions

Generate completions script per shell:

gitwise completions bash > ~/.local/share/bash-completion/completions/gitwise
gitwise completions zsh > ~/.zsh/completions/_gitwise
gitwise completions fish > ~/.config/fish/completions/gitwise.fish

Demo

License

MIT - Deiner