p10k

Configure powerlevel10k interactively

$ p10k configure

$ p10k reload

$ p10k help

p10k configure
p10k help
p10k reload

configure
    Launches an interactive configuration wizard to customize the Powerlevel10k prompt. This is the primary way to personalize the theme.

help
    Displays help information and usage instructions for the Powerlevel10k command.

reload
    Reloads the Powerlevel10k theme configuration from the .p10k.zsh file without requiring a shell restart.

Powerlevel10k (often referred to as p10k due to its configuration command) is a feature-rich and exceptionally fast theme for the Zsh (Z Shell) shell. It aims to provide a beautiful, informative, and responsive command prompt that enhances the user's terminal experience.

Key features include dynamic prompt segments displaying information like Git status, current directory, time, battery level, and more. Its distinguishing characteristic is the p10k configure interactive wizard, which allows users to extensively customize the prompt's appearance, layout, and information displayed without manually editing configuration files.

Powerlevel10k is renowned for its low latency, even with many segments enabled, and its highly optimized rendering. It relies on Nerd Fonts for the display of various icons and glyphs, providing a visually rich interface.

Powerlevel10k is exclusively designed for the Zsh shell and will not work with other shells like Bash or Fish.
Full display of icons and glyphs requires a Nerd Font to be installed and configured in your terminal emulator. Without a Nerd Font, some prompt elements may appear as broken characters.
While highly optimized, extreme customization or the use of many complex segments can still have a minor impact on prompt rendering speed.

Installation typically involves cloning the Powerlevel10k Git repository into a Zsh plugin directory (e.g., using a plugin manager like Oh My Zsh, Antigen, or Zplug). After installation, it needs to be sourced from your .zshrc file.

The p10k configure wizard generates a configuration file named .p10k.zsh in your home directory. This file contains all your prompt settings and is automatically sourced by your .zshrc when Zsh starts.

Powerlevel10k was created by Roman Perekhrest and first released in 2018. It quickly gained popularity as a successor to and alternative to other Zsh themes, particularly Powerlevel9k, by significantly improving performance and introducing the user-friendly interactive configuration wizard. Its focus on speed, extensive customization, and ease of setup contributed to its rapid adoption among Zsh users, establishing it as one of the most widely used Zsh themes.

zsh(1), oh-my-zsh(1) (framework), starship(1) (alternative prompt), fonts(7) (general font information)