gitflect
Menu
Docs Install Shell setup GitHub Support

Git context, kept close to your prompt.

Install gitflect Read the docs
gitflect — bash

gitflect adds a compact repository segment to the prompt you already use. It shows branch state, file counts, upstream divergence, in-progress operations, and completions without becoming a shell framework.

Small by design.

gitflect focuses on one job: render Git state quickly and predictably for interactive shells.

Preserves your prompt

Keeps username, host, path, colors, and prompt marker intact by default.

Git-aware output

Shows branch, detached HEAD, dirty counts, stash count, and operation state.

Native binary

Built in Rust for low startup overhead and simple GitHub release installs.

Start in one line.

Install from GitHub Releases, then load the shell integration.

GitHub release installer Fetches the right archive, installs into your user bin path, and leaves shell setup explicit. 
curl -fsSL https://raw.githubusercontent.com/shravanngoswamii/gitflect/main/install.sh | sh
Shell setup

Documentation.

Focused pages for installation, prompt behavior, configuration, completions, and releases.

Install

Download the right release archive and place `gitflect` on your path.

Prompt segments

Understand branch symbols, dirty counts, upstream state, and operation markers.

Configuration

Tune colors, symbols, status behavior, branch display, and large repository handling.

gitflect's prompt format and status symbols are directly inspired by posh-git — the Git integration for PowerShell — adapted for Bash and Zsh on Linux and macOS.

FAQ

Quick answers for search engines and humans.

What is gitflect?

A native CLI that shows Git branch and status context in your existing shell prompt.

Which shells are supported?

Bash and Zsh on Linux and macOS.

Can I customize it?

Yes. You can tune colors, symbols, and behavior with config keys.