Back to blog

2026-08-07

Goroutine: a minimal Oh My Zsh theme

A bright, minimal Oh My Zsh theme inspired by Go.

I made a new Oh My Zsh theme called goroutine.

It started with the built-in apple theme as a reference, but I wanted something closer to Go’s practical style: bright, minimal, and focused on the context that matters while working.

Goroutine Oh My Zsh prompt

The prompt shows the current directory, detected runtimes, and Git context in a single line. Command input is intentionally left unprefixed.

What it detects

  • macOS and supported Linux distributions, when using a Nerd Font
  • Go projects through go.mod
  • Python projects through common environment and dependency files
  • Node.js projects through package.json, lockfiles, and version files
  • The current Git branch and a tag when it points exactly to HEAD

Runtime versions follow a fixed order: Go, Python, then Node.js.

Install

Clone the repository, then symlink the theme into Oh My Zsh’s custom themes directory:

Set it in .zshrc:

ZSH_THEME="goroutine"

Restart the shell or run:

Configuration

The theme enables its contextual segments by default:

GOROUTINE_SHOW_OS_LOGO=1
GOROUTINE_SHOW_RUNTIMES=1
GOROUTINE_SHOW_GIT_TAG=1
GOROUTINE_PROMPT=''

ZSH_THEME="goroutine"

Set a GOROUTINE_SHOW_* variable to 0 to hide that segment. GOROUTINE_PROMPT can append a small custom label to the prompt.

The theme requires a Nerd Font for operating system icons.

Continue reading