🚀 OhMyPosh Atomic Enhanced

This repository provides a custom theme configuration for Oh My Posh, a cross-platform prompt theming engine for shells like PowerShell, Bash, and Zsh. Inspired by the AtomicBit theme, this project aims to deliver a visually rich, highly informative, and developer-friendly prompt experience. It is designed for users who want a modern, customizable shell prompt with enhanced status indicators, dynamic segments, and consistent appearance across Windows, Linux, and macOS terminals.

Whether you’re a developer or power user, this theme helps you work faster and smarter by making your shell prompt more informative and visually appealing.

Windows Terminal showcasing the Atomic Enhanced Oh My Posh prompt with left/right blocks, git status, and dynamic battery/system info.

Windows Terminal showcasing the Atomic Enhanced Oh My Posh prompt with experimental dividers enabled. (Recommended)

📑 Table of Contents

• How the OhMyPosh Custom Theme Works
  • Theme Structure
    • Left-Aligned Prompt
    • Right-Aligned Prompt (same-line; alignment: “right”)
    • Right Prompt (explicit rprompt block)
    • Newline Block
• Key Features
• Oh-My-Posh Installation
• How to Use
• Advanced Customization
• Documentation
  • Using Palette Entries
• Theme Styles
• Theme Gallery

🧩 How the OhMyPosh Custom Theme Works

See: General Configuration • Theme Files • Segment Docs (example: Git)

[NOTE] This theme is highly customizable–feel free to tweak colors and segments! 🚀

This theme is a highly customized configuration for Oh My Posh, designed to provide a visually rich, informative, and efficient prompt for your shell. It leverages advanced features of Oh My Posh, including segment styling, dynamic templates, mapped locations, and tooltips for various development environments.

🧱 Theme Structure

Docs: JSON Schema (section: Validation) · Block Config · Segment Config

• Schema: The theme uses the official Oh My Posh theme schema for validation and compatibility.
• Accent Color: Sets a primary accent color for visual consistency.
• Blocks: The prompt is divided into multiple blocks, each with its own alignment (left, right, or newline) and segments.

◀️ Left-Aligned Prompt

Relevant segments: shell · root · path · git · executiontime · status

Contains segments for:

• Shell Info 🐚: Displays shell name and version, with mapped names for common shells.
• Root Status 🔐: Highlights if running as administrator/root.
• Path 📁: Shows the current directory, with custom icons and mapped locations for quick recognition (e.g., “UW” for Uptime-Watcher repo, icons for Desktop/Documents/Downloads).
• Git 🌿: Shows branch, status, and upstream info, with color changes based on git state.
• Execution Time ⏱️: Displays how long the last command took to run.
• Status ✅/❌: Indicates success or error of the last command.

▶️ Right-Aligned Prompt (same-line; alignment: “right”)

Relevant segments: sysinfo · os · time · weather/owm · battery · node · npm · java · python · dotnet · upgrade · gitversion

Contains segments for:

• System Info 🧮: CPU, memory, and disk usage, with dynamic coloring.
• OS Info 🖥️: Shows the operating system and WSL status.
• Time 🕒: Current date and time, with customizable format.
• Weather ☀️: Displays current temperature using OpenWeatherMap (OWM), with units and timeout settings.
• Battery 🔋: Shows battery status and state, with color changes for charging/discharging/full.
• Runtime badges & package managers ⚙️: Shows runtime details for Node, Java, Python, .NET and package manager badges (npm/pnpm/yarn), useful in developer workflows.
• Upgrade & Tooling Notices ⚠️: The upgrade segment shows whether tool or theme updates are available.
• GitVersion (slimfat): In the slimfat family, gitversion displays version metadata for project release or tagged versions.

➡️ Right Prompt (explicit rprompt block)

Relevant segments: promptcounter · upgrade · root · copilot (experimental, rprompt)

Contains segments for:

• Prompt Count #️⃣: Shows the number of prompts in the session.
• Upgrade Notice ⬆️: Indicates if Oh My Posh can be upgraded.
• Root Status ⚡: Quick root indicator.
• Copilot gauge 🤖 (experimental): Shows Copilot premium quota and percent remaining in the rprompt block when integration is available.

Note: Some segments may appear as ‘alignment: right’ (same-line right-aligned) or in an explicit rprompt block depending on the theme family. For example, copilot appears as an rprompt-type segment in experimentalDividers, while runtime badges (node, npm, java, python, etc.) are frequently in alignment: right blocks across families.

⤵️ Newline Block

Relevant segments: text (decorative line) · session · status

Contains segments for:

• Decorative Line ─: Visual separator for prompt clarity.
• Session Info 👤: Shows username and SSH session status.
• Status ✅/❌: Indicates command status with icons.

✨ Key Features

Docs: Templates · Mapped Locations · Caching (section removed: see General Config for related settings) · Styles & Separators (see General Config) · Tooltips

• Dynamic Templates 🧬: Many segments use Go template syntax to display context-aware information (e.g., git status, shell name, mapped locations).
• Mapped Locations 🗺️: Custom folder names/icons for frequently used paths, making navigation easier.
• Segment Styling 💎: Uses “diamond” and “powerline” styles for modern, visually appealing separators and backgrounds.
• Caching ⚡: Segments cache their data for performance, with customizable durations and strategies (e.g., session, folder).
• Tooltips 💡: Provides quick info for common tools (React, TypeScript, Node, Java, Git, etc.) when detected in the current folder.
• HTTP tooltips & enrichment 🛰️: Several tooltips use the http segment to fetch metadata about packages, versions, and remote services. Common examples included in the themes:
  • React, TypeScript, Vite, Playwright & Vitest (fetching npm registry versions)
  • Prettier, Axios, Zod and other packages used as small badges/tooltips
  • IP lookups via ipify (IPv4/IPv6) for quick network visibility
  • GitVersion & Git metadata via HTTP or local lookups (Slimfat) Tooltips are defined per-theme and may vary across variants.
• Status and Error Handling 🚦: Segments change color and icons based on command success, errors, or git state.
• Customization 🎯: Nearly every aspect (colors, icons, templates, widths) can be adjusted to fit your workflow and preferences.

📦 Per-Family Segment Highlights

Some segments are specific to certain theme families; the main custom families are: experimentalDividers, OhMyPosh-Atomic-Custom (atomic custom), 1_shell, slimfat, atomicBit, and cleanDetailed.

• Experimental Dividers (highlight): copilot — An interactive Copilot gauge showing premium quota/percent (shown when a Copilot premium API or status is available) and it lives in an rprompt block; HTTP tooltips, npm/node/java runtime badges are often right-aligned same-line segments. Experimental Dividers also include rich HTTP tooltips and IP lookups (ipify).
• Atomic Custom: Common runtime badges and package checks (node, npm, java, upgrade) used for everyday project contexts.
• Slimfat: Focused on compact displays and additional project/runtime segments like gitversion, project, and Windows-specific winreg info.
• AtomicBit: Developer-focused segments for language and platform tooling — angular, aurelia, aws, kubectl, nx, dart, go, julia, rust, ruby, and others; these appear mostly in this family.

If you need a segment added to README that’s used only by an official theme (not one of the custom families), let me know and I’ll add a note under “Official Families” instead.

📋 Detailed Segment Index (by family)

Below is a convenience index showing which segments are used in each family of themes. This helps contributors see at a glance which segments are available in a family and which are exclusive. ### experimentalDividers - `battery` - `connection` - `copilot` - `executiontime` - `git` - `gitversion` - `http` - `ipify` - `java` - `node` - `npm` - `os` - `owm` - `path` - `project` - `python` - `react` - `root` - `session` - `shell` - `status` - `sysinfo` - `text` - `time` - `upgrade` - `winreg` ### atomicCustom - `battery` - `connection` - `executiontime` - `git` - `gitversion` - `http` - `ipify` - `java` - `node` - `npm` - `os` - `owm` - `path` - `project` - `python` - `react` - `root` - `session` - `shell` - `status` - `sysinfo` - `text` - `time` - `upgrade` - `winreg` ### 1_shell - `battery` - `connection` - `executiontime` - `git` - `gitversion` - `http` - `ipify` - `java` - `node` - `os` - `path` - `project` - `python` - `react` - `root` - `session` - `shell` - `status` - `sysinfo` - `text` - `time` - `upgrade` - `winreg` ### slimfat - `battery` - `connection` - `dotnet` - `executiontime` - `git` - `gitversion` - `http` - `ipify` - `java` - `node` - `os` - `path` - `project` - `python` - `react` - `root` - `session` - `shell` - `status` - `sysinfo` - `text` - `time` - `upgrade` - `winreg` ### atomicBit - `angular` - `aurelia` - `aws` - `azfunc` - `battery` - `connection` - `dart` - `dotnet` - `executiontime` - `git` - `gitversion` - `go` - `http` - `ipify` - `java` - `julia` - `kubectl` - `node` - `nx` - `os` - `owm` - `path` - `project` - `python` - `react` - `root` - `ruby` - `rust` - `session` - `shell` - `status` - `sysinfo` - `text` - `time` - `upgrade` - `winreg` ### cleanDetailed - `battery` - `connection` - `executiontime` - `git` - `gitversion` - `http` - `ipify` - `java` - `node` - `os` - `path` - `project` - `python` - `react` - `root` - `session` - `shell` - `status` - `sysinfo` - `text` - `time` - `upgrade` - `winreg`

📦 Oh-My-Posh Installation

Docs: Installation: Windows · macOS · Linux · Fonts · Customize

1. Windows
2. Linux
3. MacOS

🛠️ How to Use

1. Quick Start (from GitHub URL): You can use the theme directly from the GitHub repository without downloading it:

oh-my-posh init pwsh --config "https://raw.githubusercontent.com/Nick2bad4u/OhMyPosh-Atomic-Enhanced/main/OhMyPosh-Atomic-Custom.json" | Invoke-Expression

1. Local Setup: Copy the theme JSON (OhMyPosh-Atomic-Custom.json) to your system. Set your shell to use this theme with Oh My Posh:

oh-my-posh init pwsh --config "<path-to>/OhMyPosh-Atomic-Custom.json" | Invoke-Expression

Customize mapped locations, icons, and colors as needed in the JSON file.

🧪 Advanced Customization

Docs: Segment Config · Templates Guide · Palette & Colors · Tooltips

• Segment Properties: Each segment type (shell, path, git, etc.) has its own properties for fine-tuning behavior and appearance.
• Templates: Use Go template expressions to display dynamic info (see Oh My Posh docs).
• Tooltips: Add or modify tooltips for your favorite tools and languages.

For more details, see the Oh My Posh documentation.

📚 Documentation

For comprehensive guides, configuration options, and troubleshooting, refer to the official Oh My Posh documentation at https://ohmyposh.dev/docs.

🎨 Palette & Color Groups

The theme centralizes all colors in a `palette` so segments and templates stay consistent and easy to tweak. Colors are grouped by functional intent rather than pure hue. Use `p:` anywhere a color is accepted (foreground/background, templates like `` or `<p:fg,p:bg>`). | Group | Key | Description | | ------------------------------------------------------ | ------------------------------------------------------ | ------------------------------------------------------------- | | Core / Base | `accent` | Primary accent and prompt line markers. | | `black`, `white` | Base monochrome anchors. | | Blues (Shell / Time / Info) | `blue_primary` | Shell segment background & transient prompt color. | | `blue_time` | Time and connection segments. | | `blue_tooltip` | Tooltip foreground accents. | | `windows_blue` | Windows registry/version segment. | | `python_blue` | Python runtime background. | | `navy_text` | Dark readable foreground on bright yellows. | | Purples (Session / Branch State / Execution) | `purple_session` | Session username & debug banners. | | `purple_ahead` | Git ahead/behind highlighting. | | `purple_exec` | Execution time segment. | | `violet_project` | Project/workspace segment. | | Reds & Pinks (Errors / Alerts) | `red_alert` | Root/admin & error emphasis. | | `red_deleted` | Git deleted files counter. | | `maroon_error` | Error status background. | | `pink_error_line` | Error line symbol in multiline prompts. | | `pink_status_fail` | Failure state in status templates. | | Oranges (Path / Battery / Java / General Warm Accents) | `orange` | Path and tooltip path segment. | | `orange_unmerged` | Git unmerged count. | | `orange_battery` | Battery base color. | | `java_orange` | Java version tooltip. | | Yellows (Attention / Status / Update) | `yellow_bright` | Git base background & root foreground; high-attention blocks. | | `yellow_modified` | Git modified files. | | `yellow_git_changed` | Git working/staging changed blend. | | `yellow_update` | Upgrade notification segment. | | `yellow_root_alt` | Alt root indicator (rprompt). | | `yellow_discharging` | Battery discharging state. | | Greens (Success / Health / Battery / Helpers) | `green_added` | Git added files. | | `green_ahead` | Combined ahead/behind git state. | | `green_full` | Battery full state. | | `green_success` | Command success background template. | | `green_help` | Help / generic info text badge. | | `green_valid_line` | Valid line symbol. | | `green_charging` | Battery charging state. | | Cyans | `cyan_renamed` | Git renamed files count. | | `cyan_status_fg` | Status indicator foreground (multiline tail). | | Magenta | `magenta_copied` | Git copied files count. | | Weather / Misc | `pink_weather` | Weather segment background. | | Grays (Neutral/UI Framing) | `gray_os` | OS segment background. | | `gray_os_fg` | OS / neutral text foreground & reused for subtle text. | | `gray_untracked` | Git untracked file count. | | `gray_prompt_count_bg` | Prompt count background. | | `gray_prompt_count_fg` | Prompt count foreground. | | `gray_path_fg` | Path tooltip foreground & neutral dark text. | | Language / Tool Specific | `node_green` | Node.js / package manager tooltip background. | | `python_yellow` | Python secondary (logo yellow). | </details> ### Using Palette Entries Examples: ```jsonc "foreground": "p:accent" "background": "p:blue_primary" "template": " OK </> ERR </>" "background_templates": ["p:maroon_error"] ``` This structure lets you retheme quickly: adjust a palette value once and every segment using it updates automatically. The included [`validate-palette.ps1`](/OhMyPosh-Atomic-Enhanced/validate-palette.ps1) script (located in the root of this repository) checks that every `p:` reference in the config matches a palette entry. It also reports any unused palette keys. > [!WARNING] Always run the validation script after changes to avoid palette mismatches! ⚠️ **Note:** Requires PowerShell 7 or later. No external modules are needed; the script uses only built-in PowerShell features. **Note:** Run the following command from the repository root to ensure correct results. Run it (from repo root): ```pwsh pwsh ./validate-palette.ps1 ``` Exit codes: - `0` clean (no missing/unused) - `2` missing references - `3` only unused keys After making changes to the palette or theme configuration, run this script to ensure all palette references are valid and unused keys are reported--helping keep your configuration clean and error-free. ## 🎨 Theme Styles This repository includes **5 unique theme styles**, each available in **24 color palettes** (120 total themes): ### 🚀 OhMyPosh Atomic Custom The flagship theme with comprehensive features: - Multi-line layout with left and right blocks - Extensive git status with visual indicators - Language/framework detection (Node, Python, .NET, Java, Go, Rust, Angular, React, etc.) - System info (memory, CPU, battery) - Weather integration - Custom path mapping with smart icons - Execution time and status tracking ### ✨ 1_shell Enhanced A sleek single-line theme based on the official 1_shell: - Clean, compact design - Git integration with status colors - Session info and OS detection - Smart path display with mapped locations - Battery status with color indicators ### 🎯 Slimfat Enhanced Two-line compact theme with modern styling: - OS icon with session info - Enhanced git status on primary line - Language segments (Node, Python, .NET) - Time display and battery status - Clean execution time and status on second line ### 📦 AtomicBit Enhanced Box-style technical theme: - Bracketed session display - Path with smart location mapping - Multiple language support - OS info and battery status - Git status on separate line - Compact technical aesthetic ### 🧹 Clean-Detailed Enhanced Minimalist clean theme with essential info: - OS and shell information - System memory statistics - Execution time tracking - Enhanced git with upstream icons - Time and root indicators - Smart path with mapped locations --- ## 🎨 Theme Gallery All themes are available in multiple color palettes. Choose the one that fits your style! ### 🌈 Experimental Dividers Variants (NEW) **Copilot gauge (experimental):** The Experimental Dividers family includes an optional Copilot segment that displays the Copilot premium gauge and percent remaining on the right prompt. This segment requires Copilot integration and is intentionally only included in the experimental family as a demo of more advanced, context-aware telemetry.

AmberSunset	BlueOcean
CatppuccinMocha	CherryMint
ChristmasCheer	DraculaNight
EasterPastel	FireIce
ForestEmber	GreenMatrix
GruvboxDark	HalloweenSpooky
LavenderPeach	MidnightGold
MonokaiPro	NordFrost
Original	PinkParadise
PurpleReign	RainbowBright
RedAlert	SolarizedDark
TealCyan	TokyoNight

### 🚀 OhMyPosh Atomic Custom Variants

AmberSunset	BlueOcean
CatppuccinMocha	CherryMint
ChristmasCheer	DraculaNight
EasterPastel	FireIce
ForestEmber	GreenMatrix
GruvboxDark	HalloweenSpooky
LavenderPeach	MidnightGold
MonokaiPro	NordFrost
Original	Original
PinkParadise	PurpleReign
RainbowBright	RedAlert
SolarizedDark	TealCyan
TokyoNight

### ✨ 1_shell-Enhanced Variants

AmberSunset	BlueOcean
CatppuccinMocha	CherryMint
ChristmasCheer	DraculaNight
EasterPastel	FireIce
ForestEmber	GreenMatrix
GruvboxDark	HalloweenSpooky
LavenderPeach	MidnightGold
MonokaiPro	NordFrost
Original	PinkParadise
PurpleReign	RainbowBright
RedAlert	SolarizedDark
TealCyan	TokyoNight

### 🎯 Slimfat-Enhanced Variants

AmberSunset	BlueOcean
CatppuccinMocha	CherryMint
ChristmasCheer	DraculaNight
EasterPastel	FireIce
ForestEmber	GreenMatrix
GruvboxDark	HalloweenSpooky
LavenderPeach	MidnightGold
MonokaiPro	NordFrost
Original	PinkParadise
PurpleReign	RainbowBright
RedAlert	SolarizedDark
TealCyan	TokyoNight

### 📦 AtomicBit-Enhanced Variants

AmberSunset	BlueOcean
CatppuccinMocha	CherryMint
ChristmasCheer	DraculaNight
EasterPastel	FireIce
ForestEmber	GreenMatrix
GruvboxDark	HalloweenSpooky
LavenderPeach	MidnightGold
MonokaiPro	NordFrost
Original	PinkParadise
PurpleReign	RainbowBright
RedAlert	SolarizedDark
TealCyan	TokyoNight

### 🧹 Clean-Detailed-Enhanced Variants

AmberSunset	BlueOcean
CatppuccinMocha	CherryMint
ChristmasCheer	DraculaNight
EasterPastel	FireIce
ForestEmber	GreenMatrix
GruvboxDark	HalloweenSpooky
LavenderPeach	MidnightGold
MonokaiPro	NordFrost
Original	PinkParadise
PurpleReign	RainbowBright
RedAlert	SolarizedDark
TealCyan	TokyoNight

### 🎯 Quick Install To use any theme, copy the command for your preferred variant: ```pwsh # Replace and with the desired theme names oh-my-posh init pwsh --config "https://raw.githubusercontent.com/Nick2bad4u/OhMyPosh-Atomic-Enhanced/main//" | Invoke-Expression ``` **Theme File Naming Convention:** - OhMyPosh-Atomic-Custom..json - Flagship comprehensive theme - 1_shell-Enhanced.omp..json - Single-line sleek theme - slimfat-Enhanced.omp..json - Two-line compact theme - \atomicBit-Enhanced.omp..json - Box-style technical theme - clean-detailed-Enhanced.omp..json - Minimalist clean theme **Examples:** ```pwsh # Atomic Custom with Nord Frost palette oh-my-posh init pwsh --config "https://raw.githubusercontent.com/Nick2bad4u/OhMyPosh-Atomic-Enhanced/main/atomic/OhMyPosh-Atomic-Custom.NordFrost.json" | Invoke-Expression # 1_shell Enhanced with Tokyo Night palette oh-my-posh init pwsh --config "https://raw.githubusercontent.com/Nick2bad4u/OhMyPosh-Atomic-Enhanced/main/1_shell-Enhanced.omp.TokyoNight.json" | Invoke-Expression # Slimfat Enhanced with Dracula Night palette oh-my-posh init pwsh --config "https://raw.githubusercontent.com/Nick2bad4u/OhMyPosh-Atomic-Enhanced/main/slimfat/slimfat-Enhanced.omp.DraculaNight.json" | Invoke-Expression # AtomicBit Enhanced with Gruvbox Dark palette oh-my-posh init pwsh --config "https://raw.githubusercontent.com/Nick2bad4u/OhMyPosh-Atomic-Enhanced/main/atomicBit/atomicBit-Enhanced.omp.GruvboxDark.json" | Invoke-Expression # Clean-Detailed Enhanced with Catppuccin Mocha palette oh-my-posh init pwsh --config "https://raw.githubusercontent.com/Nick2bad4u/OhMyPosh-Atomic-Enhanced/main/cleanDetailed/clean-detailed-Enhanced.omp.CatppuccinMocha.json" | Invoke-Expression ``` **Available Palettes:** - **Original** - Your current vibrant tech theme - **Nord Frost** - Arctic cool tones - **Gruvbox Dark** - Warm retro earth tones - **Dracula Night** - Bold purple/pink - **Tokyo Night** - Modern neon blues - **Monokai Pro** - Classic neon colors - **Solarized Dark** - Eye-friendly - **Catppuccin Mocha** - Soft pastels - **Forest Ember** - Deep greens with amber - **Pink Paradise** - Vibrant pink/magenta 💗 - **Purple Reign** - Royal purples 👑 - **Red Alert** - Fiery reds/oranges 🔥 - **Blue Ocean** - Deep ocean blues 🌊 - **Green Matrix** - Matrix-inspired greens 💚 - **Amber Sunset** - Warm sunset tones 🌅 - **Teal Cyan** - Electric teals ⚡ - **Rainbow Bright** - Vibrant rainbow colors 🌈 - **Christmas Cheer** - Festive holiday colors 🎄 - **Halloween Spooky** - Spooky Halloween theme 🎃 - **Easter Pastel** - Soft pastel Easter colors 🐰 - **Fire & Ice** - Dual-tone red/orange and blue/cyan ❄️🔥 - **Midnight Gold** - Deep navy blue and gold ⭐ - **Cherry Mint** - Cherry red and mint green 🍒 - **Lavender Peach** - Soft lavender and warm peach 🍑 ---