# jandedobbeleer/oh-my-posh architecture

> Architecture diagram of the GitHub repository jandedobbeleer/oh-my-posh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jandedobbeleer/oh-my-posh
- Repository: https://github.com/jandedobbeleer/oh-my-posh

## Overview

Oh My Posh is a cross-platform, configurable shell prompt engine. In the principal workflow, a shell integration invokes the CLI, which uses configuration and runtime state to build prompt output; the prompt engine formats it for terminal display. The repository also supports rendering configurations to SVG in the CLI and browser, plus website tooling and MCP endpoints. The excerpts show shared render setup and selected integrations, but not the full CLI dispatch or segment execution path, so those links are omitted or marked unverified.

Main entry points: [`src/config/segment.go`](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/config/segment.go) (Prompt config), [`src/render/render.go`](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/render/render.go) (Render setup), [`src/wasm/main.go`](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/wasm/main.go) (WASM renderer), [`src/prompt/engine.go`](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/prompt/engine.go) (Prompt engine)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Shell and CLI"]
  node_shell["Shell integration<br/>[init.go]"]
  node_main["CLI entry<br/>[main.go]"]
  node_cli["CLI commands"]
end

subgraph group_engine["Prompt rendering"]
  node_config["Prompt config<br/>[segment.go]"]
  node_segments["Prompt segments"]
  node_enginecore["Prompt engine<br/>[engine.go]"]
  node_writer["Terminal writer<br/>[writer.go]"]
  node_cache[("Prompt cache")]
  node_render["Render setup<br/>[render.go]"]
  node_svg["SVG encoder<br/>[svg.go]"]
end

subgraph group_browser["Browser rendering"]
  node_wasm["WASM renderer<br/>[main.go]"]
  node_editor["Config editor<br/>[useWasmRenderer.js]"]
  node_loader["WASM loader<br/>[wasmLoader.js]"]
  node_studio["Studio<br/>[index.js]"]
end

subgraph group_site["Website services"]
  node_mcp["MCP endpoint<br/>[index.js]"]
  node_validator["Request validator<br/>[validator.js]"]
  node_segmentdata["Segment catalog data<br/>[data.js]"]
end

node_user(("Shell user"))

node_user -.->|"uses"| node_shell
node_shell -.->|"invokes CLI"| node_main
node_main -->|"calls"| node_cli
node_cli -.->|"renders prompt"| node_enginecore
node_config -->|"uses"| node_cache
node_config -.->|"executes"| node_segments
node_enginecore -->|"loads"| node_config
node_enginecore -->|"writes output"| node_writer
node_render -->|"initializes"| node_config
node_render -->|"builds"| node_enginecore
node_render -->|"configures SVG"| node_svg
node_wasm -->|"parses config"| node_config
node_wasm -->|"uses setup"| node_render
node_wasm -.->|"returns SVG"| node_svg
node_editor -->|"loads module"| node_loader
node_editor -->|"calls renderer"| node_wasm
node_studio -.->|"uses renderer"| node_editor
node_mcp -->|"validates with"| node_validator

click node_shell "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/shell/init.go"
click node_main "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/main.go"
click node_cli "https://github.com/jandedobbeleer/oh-my-posh/tree/main/src/cli"
click node_config "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/config/segment.go"
click node_segments "https://github.com/jandedobbeleer/oh-my-posh/tree/main/src/segments"
click node_enginecore "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/prompt/engine.go"
click node_writer "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/terminal/writer.go"
click node_cache "https://github.com/jandedobbeleer/oh-my-posh/tree/main/src/cache"
click node_render "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/render/render.go"
click node_svg "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/svg/svg.go"
click node_wasm "https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/wasm/main.go"
click node_editor "https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/src/components/ConfigEditor/useWasmRenderer.js"
click node_loader "https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/src/components/ConfigEditor/wasmLoader.js"
click node_studio "https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/src/components/Studio/index.js"
click node_mcp "https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/api/mcp/index.js"
click node_validator "https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/api/shared/validator.js"
click node_segmentdata "https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/plugins/segments/data.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_shell,node_main,node_cli,node_user toneBlue
class node_config,node_segments,node_enginecore,node_writer,node_cache,node_render,node_svg toneAmber
class node_wasm,node_editor,node_loader,node_studio toneMint
class node_mcp,node_validator,node_segmentdata toneRose
```

## Components

### Shell and CLI

- [Shell integration](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/shell/init.go): `src/shell/init.go`
- [CLI entry](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/main.go): `src/main.go`
- [CLI commands](https://github.com/jandedobbeleer/oh-my-posh/tree/main/src/cli): `src/cli`

### Prompt rendering

- [Prompt config](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/config/segment.go): `src/config/segment.go`
- [Prompt segments](https://github.com/jandedobbeleer/oh-my-posh/tree/main/src/segments): `src/segments`
- [Prompt engine](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/prompt/engine.go): `src/prompt/engine.go`
- [Terminal writer](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/terminal/writer.go): `src/terminal/writer.go`
- [Prompt cache](https://github.com/jandedobbeleer/oh-my-posh/tree/main/src/cache): `src/cache`
- [Render setup](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/render/render.go): `src/render/render.go`
- [SVG encoder](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/svg/svg.go): `src/svg/svg.go`

### Browser rendering

- [WASM renderer](https://github.com/jandedobbeleer/oh-my-posh/blob/main/src/wasm/main.go): `src/wasm/main.go`
- [Config editor](https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/src/components/ConfigEditor/useWasmRenderer.js): `website/src/components/ConfigEditor/useWasmRenderer.js`
- [WASM loader](https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/src/components/ConfigEditor/wasmLoader.js): `website/src/components/ConfigEditor/wasmLoader.js`
- [Studio](https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/src/components/Studio/index.js): `website/src/components/Studio/index.js`

### Website services

- [MCP endpoint](https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/api/mcp/index.js): `website/api/mcp/index.js`
- [Request validator](https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/api/shared/validator.js): `website/api/shared/validator.js`
- [Segment catalog data](https://github.com/jandedobbeleer/oh-my-posh/blob/main/website/plugins/segments/data.js): `website/plugins/segments/data.js`

### Other components

- **Shell user**

## Connections

- Shell user → Shell integration: uses (evidence: `README.md`)
- Shell integration → CLI entry: invokes CLI
- CLI entry → CLI commands: calls (evidence: `src/main.go`)
- CLI commands → Prompt engine: renders prompt
- Prompt config → Prompt cache: uses (evidence: `src/config/segment.go`)
- Prompt config → Prompt segments: executes (evidence: `src/config/segment.go`)
- Prompt engine → Prompt config: loads (evidence: `src/prompt/engine.go`)
- Prompt engine → Terminal writer: writes output (evidence: `src/prompt/engine.go`)
- Render setup → Prompt config: initializes (evidence: `src/render/render.go`)
- Render setup → Prompt engine: builds (evidence: `src/render/render.go`)
- Render setup → SVG encoder: configures SVG (evidence: `src/render/render.go`)
- WASM renderer → Prompt config: parses config (evidence: `src/wasm/main.go`)
- WASM renderer → Render setup: uses setup (evidence: `src/wasm/main.go`)
- WASM renderer → SVG encoder: returns SVG
- Config editor → WASM loader: loads module (evidence: `website/src/components/ConfigEditor/useWasmRenderer.js`)
- Config editor → WASM renderer: calls renderer (evidence: `website/src/components/ConfigEditor/useWasmRenderer.js`)
- Studio → Config editor: uses renderer (evidence: `website/src/components/ConfigEditor/useWasmRenderer.js`)
- MCP endpoint → Request validator: validates with (evidence: `website/api/mcp/index.js`)
