OctoTUI

A terminal UI for Git, inspired by GitKraken

Installation • Screenshots

OctoTUI brings a GitKraken-like experience to your terminal. Visual diffs, hunk-level staging, branch management, commit history—all without leaving the command line.

Features

• 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

Screenshots

Status Tab

Repository status at a glance: branch, remote tracking, sync status (ahead/behind), working tree operations.

Files Tab

Browse your repository with a tree view. Press e to open files in your editor.

Unstaged Changes

Review unstaged changes with syntax-highlighted diffs. Stage or discard individual hunks.

Staged Changes

See what's going into your next commit. Unstage hunks if needed.

Commit Tab

Write commit messages with subject and body, or generate them with AI.

Settings Tab

Configure your editor, theme, and AI provider. Supports 30+ providers including OpenAI, Anthropic, and Ollama.

Installation

Quick Start

uvx octotui

From Source

git clone https://github.com/never-use-gui/octotui.git
cd octotui
uv run octotui

Requirements

• Python 3.11+
• Git
• Terminal with 256+ colors

Profiling & Debugging

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 octotui

After using the app, check the profile log for a summary of slow functions:

cat ~/.octotui_profile.log | tail -30

The summary shows function call counts, total time, average time, and min/max times—sorted by total time (slowest first).

Tech Stack

• Textual - TUI framework
• GitPython - Git operations
• GAC - AI commit generation

License

MIT - see LICENSE