23.6K ·GitHub
What is this?
oh-my-posh is a cross-platform prompt theme engine: it renders the prompt line you see in your terminal, and it is built to be highly customizable and extensible.
oh-my-posh is a cross-platform prompt theme engine: it renders the prompt line you see in your terminal, and it is built to be highly customizable and extensible.Does it replace my shell, or does it run inside the one I already have?It doesn't replace anything — your shell stays as is, and oh-my-posh only takes over drawing the prompt. The project describes itself as shell and platform agnostic.
It doesn't replace anything — your shell stays as is, and oh-my-posh only takes over drawing the prompt. The project describes itself as shell and platform agnostic.How do I install it and switch my prompt to it?It ships as a single Go binary: install it for your OS using the guides at ohmyposh.dev, then point your shell config at oh-my-posh so it renders your prompt, and pick a theme.
It ships as a single Go binary: install it for your OS using the guides at ohmyposh.dev, then point your shell config at oh-my-posh so it renders your prompt, and pick a theme.Which shells can I use it with?Most of them: bash, zsh, fish, PowerShell, cmd and nushell are all supported, and it runs on Windows, macOS and Linux.
Most of them: bash, zsh, fish, PowerShell, cmd and nushell are all supported, and it runs on Windows, macOS and Linux.Will the icons in the themes just work, or do I need a special font?The themes lean on Nerd Fonts — fonts patched with extra icon glyphs (the repo carries a nerd-fonts topic) — so install one in your terminal for the icons to render correctly.
The themes lean on Nerd Fonts — fonts patched with extra icon glyphs (the repo carries a nerd-fonts topic) — so install one in your terminal for the icons to render correctly.Why did the author rewrite it instead of continuing oh-my-posh2?oh-my-posh started as the offspring of oh-my-posh2 for PowerShell. After 4 years of working on it, the author needed a modern, more efficient tool to suit his personal needs — that became the cross-platform engine hosted in this repo.
oh-my-posh started as the offspring of oh-my-posh2 for PowerShell. After 4 years of working on it, the author needed a modern, more efficient tool to suit his personal needs — that became the cross-platform engine hosted in this repo.What do right prompt, transient prompt and secondary prompt actually do?They are extra prompt surfaces: the right prompt places info on the right side of the terminal, the secondary prompt adds a second prompt line, and transient prompt lets lines you already entered collapse to a shorter form — more context without cluttering the active line.
They are extra prompt surfaces: the right prompt places info on the right side of the terminal, the secondary prompt adds a second prompt line, and transient prompt lets lines you already entered collapse to a shorter form — more context without cluttering the active line.Does it show git info in the prompt?Yes — git is one of its headline integrations and a core project topic: the prompt can reflect the repository you are in as you move around your filesystem.
Yes — git is one of its headline integrations and a core project topic: the prompt can reflect the repository you are in as you move around your filesystem.What are similar projects?powerlevel10k, zoxide, starship, inshellisense, asdf, pure, spaceship-prompt, direnv
powerlevel10k, zoxide, starship, inshellisense, asdf, pure, spaceship-prompt, direnvWhich topics is it in?nerd-fonts, terminal-themes, cmd, fish-shell, nushell, shell-prompt, powerline, fish, zsh, prompt, powershell, bash
nerd-fonts, terminal-themes, cmd, fish-shell, nushell, shell-prompt, powerline, fish, zsh, prompt, powershell, bash