gittwig 0.1.0

A terminal TUI application for managing Git branches

gittwig

A terminal user interface (TUI) for viewing and switching git branches, built with Python and Textual.

I built this because I wanted a quick way to view git branches and switch between them. Vibe-coded with Claude code.

Features

• Browse local and remote branches in a navigable list
• View changed files compared to your default branch
• View commit history unique to each branch
• Syntax-highlighted diff viewer
• Checkout branches with Enter
• Create and delete branches
• Fetch, push, and pull operations
• Filter branches with / search
• Vim-style keyboard navigation

Installation

Requires Python 3.12 or later.

# Clone the repository
git clone https://github.com/RhetTbull/gittwig.git
cd gittwig

# Install with uv (recommended)
uv sync

# Or install with pip
pip install -e .

Usage

Run twig in any git repository:

twig

Or specify a repository path:

twig /path/to/repo

Keyboard Shortcuts

Navigation

Key	Action
j / k	Move cursor down / up
h / l	Focus left / right pane
g g	Go to top of list
G	Go to bottom of list
Ctrl+d / Ctrl+u	Page down / up
Enter	Select item / checkout branch

Branch Operations

Key	Action
n	Create new branch
d	Delete branch (with confirmation)
r	Refresh data
f	Fetch from remotes
p	Push current branch
P	Pull current branch

Other

Key	Action
/	Search/filter branches
?	Show help
q	Quit
Escape	Close modal / cancel

Development

# Install development dependencies
uv sync --group dev

# Run tests
pytest

# Run linter
ruff check .

# Run type checker
mypy src

License

MIT License - see LICENSE for details.