Skip to main content

A blazing-fast TUI replacement for GitKraken - manage your Git repos with style!

Project description

OctoTUI Logo

OctoTUI

PyPI version Python License: MIT Code style: ruff

A terminal UI for Git, inspired by GitKraken

InstallationScreenshots


OctoTUI Demo

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.

Status Tab

Files Tab

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

Files Tab

Unstaged Changes

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

Unstaged Tab

Staged Changes

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

Staged Tab

Commit Tab

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

Commit Tab

Settings Tab

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

Settings Tab Settings Tab - GAC Config


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

Tech Stack

License

MIT - see LICENSE

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

octotui-0.1.13.tar.gz (51.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

octotui-0.1.13-py3-none-any.whl (60.3 kB view details)

Uploaded Python 3

File details

Details for the file octotui-0.1.13.tar.gz.

File metadata

  • Download URL: octotui-0.1.13.tar.gz
  • Upload date:
  • Size: 51.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for octotui-0.1.13.tar.gz
Algorithm Hash digest
SHA256 1204de20943e61d06debdde7124ab3cffa0f25b06d57f6f043f4016c15c35029
MD5 0c63defa99b9cba077c1141b36ac827d
BLAKE2b-256 037892171ff12d66c7eb6d1382366cfd4fc257f7aba9f5ee2f758bfe078f0fed

See more details on using hashes here.

File details

Details for the file octotui-0.1.13-py3-none-any.whl.

File metadata

  • Download URL: octotui-0.1.13-py3-none-any.whl
  • Upload date:
  • Size: 60.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for octotui-0.1.13-py3-none-any.whl
Algorithm Hash digest
SHA256 8051e109f0630e81a5b1ec7db3c4d1d5bfe979dc44fa880811b08b8f1b738ba9
MD5 4b9fc3c69cc4f12434c4f898176c32ba
BLAKE2b-256 2ec56ce907365019e2e7baa96e395e3800cffa93cb7619022eb151dbb2300e59

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page