OctoTUI brings a GitKraken-like experience to your terminal. Visual diffs, hunk-level staging, branch management, commit history—all without leaving the command line.
- Visual diffs with syntax highlighting
- Hunk-level staging/unstaging
- Branch visualization and management
- Commit history browsing
- AI-powered commit messages (via GAC)
- 100% free and open source
Repository status at a glance: branch, remote tracking, sync status (ahead/behind), working tree operations.
Browse your repository with a tree view. Press e to open files in your editor.
Review unstaged changes with syntax-highlighted diffs. Stage or discard individual hunks.
See what's going into your next commit. Unstage hunks if needed.
Write commit messages with subject and body, or generate them with AI.
Configure your editor, theme, and AI provider. Supports 30+ providers including OpenAI, Anthropic, and Ollama.
uvx octotuigit clone https://github.com/never-use-gui/octotui.git
cd octotui
uv run octotui- Python 3.11+
- Git
- Terminal with 256+ colors
If OctoTUI is slow on large repositories, enable profiling to identify bottlenecks:
# Enable profiling (logs to ~/.octotui_profile.log)
OCTOTUI_PROFILE=1 uv run octotui /path/to/big/repo
# Use a custom log file
OCTOTUI_PROFILE=1 OCTOTUI_PROFILE_LOG=/tmp/profile.log uv run octotuiAfter using the app, check the profile log for a summary of slow functions:
cat ~/.octotui_profile.log | tail -30The summary shows function call counts, total time, average time, and min/max times—sorted by total time (slowest first).
MIT - see LICENSE