How to install oh-my-git on Ubuntu with zsh?

Use antigen by adding 'antigen use oh-my-zsh', 'antigen bundle arialdomartini/oh-my-git', and 'antigen theme' lines to your .zshrc file. Then restart zsh to download and apply the prompt.

oh-my-git vs powerline for Git status?

oh-my-git is focused solely on Git status with customizable symbols, while powerline is a broader statusline tool. oh-my-git is simpler for Git-only needs but requires similar font patching and has Bash-specific quirks.

Why is my oh-my-git prompt showing broken symbols?

This is usually due to missing patched fonts. Install a font from Awesome-Terminal-Fonts, configure your terminal to use it, and ensure both Regular and Non-ASCII font settings are correct in tools like iTerm2.

Can I use oh-my-git with Python virtualenv?

Yes, set VIRTUAL_ENV_DISABLE_PROMPT=true and use the omg_prompt_callback function in your shell startup file to display the virtualenv name properly, as detailed in the troubleshooting section.

How to change the symbols in oh-my-git?

Override variables like omg_is_a_git_repo_symbol in your .bashrc or .zshrc file with your preferred glyphs, based on the defaults listed in prompt.sh or the theme files.

Is oh-my-git compatible with Windows?

It has known issues with Cygwin and isn't tested on native Windows terminals. For Windows, consider using WSL or other Unix-like environments where it might work with proper font setup.

How to disable oh-my-git for a slow repository?

Add '[oh-my-git] enabled = false' to the .git/config file of that repository to revert to the original prompt, avoiding performance hits from Git commands invoked by the prompt.

Open-Awesome

oh-my-git

MITShellv1.4

An opinionated, informative Git prompt for bash and zsh that displays repository status with custom symbols.

GitHub

3.7k stars281 forks0 contributors

What is oh-my-git?

oh-my-git is a shell prompt enhancement tool that displays detailed Git repository status directly in the terminal. It provides real-time visual indicators for branch state, uncommitted changes, remote synchronization, and other Git operations, eliminating the need to repeatedly run `git status`.

Target Audience

Developers who use Git extensively in bash or zsh shells and want immediate, at-a-glance repository status without interrupting their workflow.

Value Proposition

It offers a highly informative yet customizable prompt that improves Git awareness and productivity, with support for themes, custom symbols, and per-repository configuration.

Overview

An opinionated git prompt for bash and zsh

Use Cases

Best For

Enhancing terminal prompts with detailed Git status information
Visualizing branch divergence and remote tracking states
Monitoring staged, modified, and untracked files in real-time
Customizing shell prompts with unique symbols and themes
Improving workflow awareness during merges, rebases, and detached HEAD states
Integrating Git status with virtualenv or other shell customizations

Not Ideal For

Environments using Cygwin or non-standard Windows terminals
Very large Git repositories where prompt latency is a critical concern
Users who prefer minimal terminal setups without installing custom fonts
Teams or systems relying on Git versions older than 1.8.4

Pros & Cons

Pros

Comprehensive Git Status

Displays symbols for untracked files, staged changes, modifications, and remote tracking, providing real-time repository awareness without running extra commands.

High Customizability

Allows overriding default symbols via shell variables and supports multiple themes like oppa-lana-style, with per-repository disabling for performance control.

Shell and Tool Integration

Works with both bash and zsh, integrates with antigen for zsh, and offers a callback function for proper Python virtualenv display.

Performance Flexibility

Can be disabled per-repository via .git/config to avoid slowdowns in large repos, as mentioned in the README for handling performance issues.

Cons

Font and Terminal Dependencies

Requires patched fonts like Awesome-Terminal-Fonts for full theme support, which can be a setup barrier and cause display issues if not configured correctly.

Bash-Specific Visual Issues

On bash, the last symbol can appear broken with non-black backgrounds, requiring manual color adjustments in .bashrc, as admitted in the troubleshooting section.

Limited Cross-Platform Testing

Only tested on Mac and Ubuntu; known issues with Cygwin and lack of support for other environments, reducing reliability on diverse systems.

Setup and Maintenance Overhead

Installation involves cloning repos, modifying shell startup files, and font configuration, which can be complex and error-prone for casual users.

Frequently Asked Questions

Related Projects

powerlevel10k

A Zsh theme

Stars54,779

Forks2,432

Last commit1 month ago

spaceship

🚀✨ Minimalistic, powerful and extremely customizable Zsh prompt

Stars20,546

Forks970

Last commit9 days ago

pure

Pretty, minimal and fast ZSH prompt

Stars14,360

Forks1,008

Last commit7 days ago

powerlevel9k

Powerlevel9k was a tool for building a beautiful and highly functional CLI, customized for you. P9k had a substantial impact on CLI UX, and its legacy is now continued by P10k.

Stars13,423

Forks915

Last commit6 years ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub