explaingit

jandedobbeleer/oh-my-posh

📈 Trending★ 22,571GoAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

A terminal prompt customizer that replaces your plain command-line prompt with a styled, information-rich display showing Git status, time, battery, and more across all shells and operating systems.

Mindmap

mindmap
  root((Oh My Posh))
    What it does
      Customizes terminal prompt
      Shows Git branch status
      Displays system info
    Features
      Multi-shell support
      Cross-platform
      JSON/YAML config
    Use cases
      Developer workflows
      Git-heavy projects
      Terminal personalization
    Tech stack
      Go language
      Shell integration
      Theme system

Things people build with this

USE CASE 1

Display your current Git branch and repo status in the prompt so you always know what you're working on.

USE CASE 2

Show system info like battery level, time, and programming language versions without running separate commands.

USE CASE 3

Create a visually distinct prompt that matches your personal style or team branding across all your machines.

Tech stack

GoBashZshFishPowerShellJSONYAML

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose, including commercial use, as long as you keep the copyright notice and license text.

In plain English

Oh My Posh is a tool that customizes the appearance of your terminal prompt, the text that appears on the command line every time you type a command. By default, most terminals show a plain, minimal prompt. Oh My Posh lets you replace that with a richly styled, information-dense prompt that can show things like your current Git branch, the time, battery level, programming language version, and more, all color-coded and styled with custom icons and themes. It works by sitting between your shell and the display, reading context about your environment and rendering a prompt based on a configuration file you control. It supports virtually all popular shells, including bash, zsh, fish, PowerShell, and the Windows command prompt, and runs on Linux, macOS, and Windows. You would use Oh My Posh if you spend a lot of time in the terminal and want your prompt to be visually informative and personally styled. It is especially popular among developers who work with Git frequently, since it can display branch names and repo status at a glance without typing extra commands. The tool is written in Go for speed, keeping prompt generation fast so it does not slow down your typing. Configuration is done through a JSON or YAML theme file.

Copy-paste prompts

Prompt 1
How do I install Oh My Posh and set it up with my shell to show Git branch information in my prompt?
Prompt 2
Create a custom Oh My Posh theme that displays my current directory, Git status, and the time in a single line.
Prompt 3
I want to use Oh My Posh on Windows PowerShell to show battery level and system info, what's the quickest way to get started?
Prompt 4
Show me how to configure Oh My Posh to display different prompts for different Git repositories.
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.