JanDeDobbeleer/oh-my-posh
Oh My Posh
This project is a cross-platform shell prompt engine designed to render dynamic, themeable command line interfaces. It functions as a modular system that replaces the native shell prompt with a highly customizable, icon-rich display, allowing users to inject real-time system status, environment context, and visual design elements directly into their terminal workspace.
The engine distinguishes itself through a declarative configuration schema that enables users to define prompt layouts, color palettes, and functional behaviors across different operating systems and shell environments. By utilizing a segment-based architecture, it allows for the independent composition of prompt elements, which can be toggled, reordered, or conditionally displayed based on runtime logic and environment variables.
The tool provides a comprehensive suite of capabilities for managing the terminal interface, including asynchronous data fetching to maintain shell responsiveness, template-based rendering for dynamic content, and performance-oriented caching of segment data. It also includes utilities for configuration management, such as live reloading, schema validation, and the ability to preview visual changes directly within the terminal.
The system integrates with various shell environments through a lightweight initialization layer and supports advanced styling features like icon rendering, text decoration, and dynamic color application. Users can manage their terminal experience through centralized theme files, which support inheritance and overrides to maintain consistent configurations across multiple machines and sessions.
Features
- Terminal Prompt Customizers - Provides modular blocks and dynamic data rendering to customize command line prompts for improved productivity.
- Cross-Shell - Renders dynamic, themeable command line prompts across various shell environments using a declarative configuration schema.
- Shell Integration - Integrates directly into shell environments to replace native prompts with dynamic, themeable interfaces.
- Shell Prompt Themes - Loads and applies theme configurations to define the appearance and behavior of the shell prompt.
- Prompt Configuration Managers - Maintains and synchronizes prompt settings and theme files across environments using declarative configuration resources.
- Prompt Layout Engines - Structures the shell prompt by arranging visual elements into modular blocks and segments.
- Cross-Platform Shell Managers - Ensures consistent shell prompt appearance and behavior across different operating systems using a single configuration file.
- Themes - Provides beautiful, customizable shell themes.
- Command Line Styling Themes - Manages visual styles, color palettes, and layout structures for terminal prompts through centralized configuration files.
- Icon Fonts - Renders graphical symbols and icons in the command line using patched fonts.
- Declarative Configurations - Uses structured data files to define visual layouts and functional behaviors for the command line interface.
- Shell Integration Layers - Provides a lightweight initialization layer to bridge the prompt engine with various shell environments.
- Terminal Interface Enhancements - Decorates shell prompts with icons, colors, and conditional logic to create a highly readable command line workspace.
- Configuration Hot-Reloaders - Updates the shell prompt immediately after configuration changes without requiring a full terminal restart.
- Terminal Contextualization - Provides real-time system status and environment context directly within the command line to improve developer feedback.
- Template Rendering Engines - Evaluates logic and variables at runtime to generate dynamic prompt strings via a text processing engine.
- Prompt Customization Tools - Configures the visual appearance of prompt segments using predefined layout styles.
- Prompt Segment Controllers - Provides logic to conditionally display or hide specific prompt segments based on directory patterns.
- ANSI Escape Sequence Renderers - Translates high-level styling definitions into standard terminal control codes for consistent cross-platform visual output.
- Modular Architectures - Constructs prompts by composing independent, isolated components that can be toggled or reordered.
