Tailoring Your Command-Line with Oh My Posh: Exploring Module Configurations

Tailoring Your Command-Line with Oh My Posh: Exploring Module Configurations

Oh-My-Posh transforms your command-line interface into a personalized and information-rich workspace. It does this through modules, which are customizable elements in your prompt.

While numerous modules are available, this article will focus on examples of some commonly used modules and how they can be configured to enhance your terminal experience.

Overview of Oh My Posh Modules

Modules in Oh My Posh serve as building blocks for your prompt, each displaying different types of information. You can add, remove, or customize these modules in the theme’s JSON configuration file.

Examples of Configuring Common Modules

1. Path Module

  • Purpose: Displays the current directory path.
  • Customization: You can shorten the path, change colours, or display the path differently based on conditions. For instance, you might want the path to appear differently when you’re in a Git repository.

2. Git Module

  • Purpose: Shows the current Git branch and status (like changes, additions, or commits pending).
  • Customization: Configure it to display only certain Git statuses or change its appearance based on the current branch or repository status.

3. Battery Module

  • Purpose: Indicates the current battery level, which is especially useful for laptop users.
  • Customization: Set different colours or icons based on battery percentage or have it appear only when the battery is below a certain level.

4. Node.js Module

  • Purpose: Displays the currently active Node.js version.
  • Customization: Change the display format, icons, or colours, and configure it to show only when in a directory with a package.json file.

5. Python Module

  • Purpose: Shows the active Python version, which is useful when working with multiple Python projects or virtual environments.
  • Customization: Alter its appearance based on the active environment or set it to display only when a Python virtual environment is active.

6. Command Execution Time Module

  • Purpose: Displays how long a command took to execute, providing insight into script or command performance.
  • Customization: Adjust the threshold for displaying the execution time (e.g., only for commands taking more than 5 seconds) or change its format and colour.

7. Azure Module

  • Purpose: This module shows the current Azure subscription context if you’re using Azure.
  • Customization: Modify its appearance based on different subscriptions or services you’re connected to.

8. Container Module

  • Purpose: Indicates if you are working inside a Docker container.
  • Customization: Configure to show container details and customize the display style.

Implementing Module Customization

You’ll need to edit the theme’s JSON file to customise a module. Here’s a basic structure for customizing a module:

  "properties": { 


Replace module_name with the module’s name (e.g., path, git), style_options with styling options like colour or font and property_name and property_value with the specific customization options for that module.


Customizing your command line with Oh My Posh modules enhances its aesthetic appeal and boosts functionality and productivity. Each module offers unique customization options, allowing you to create a tailored environment that suits your workflow.


Hi, my name is Stephen Finchett. I have been a software engineer for over 30 years and worked on complex, business critical, multi-user systems for all of my career. For the last 15 years, I have been concentrating on web based solutions using the Microsoft Stack including ASP.Net, C#, TypeScript, SQL Server and running everything at scale within Kubernetes.