Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/romkatv/powerlevel10k/llms.txt

Use this file to discover all available pages before exploring further.

Powerlevel10k works with every major Zsh plugin manager and framework. Most managers have a dedicated one-liner that handles installation automatically; if that approach does not work in your environment, you can always fall back to the universal manual procedure, which is compatible with any setup. This page covers per-manager installation snippets, a step-by-step fallback procedure, and notes on Pure-style compatibility.

​
Per-Manager Installation

​
Oh My Zsh

Clone the repository into your Oh My Zsh custom themes directory, then set ZSH_THEME in ~/.zshrc:
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"
Open ~/.zshrc, find the line that sets ZSH_THEME, and change its value:
ZSH_THEME="powerlevel10k/powerlevel10k"

​
Prezto

Add the following line to ~/.zpreztorc:
zstyle :prezto:module:prompt theme powerlevel10k

​
Zim

Add the following line to ~/.zimrc, then run zimfw install:
zmodule romkatv/powerlevel10k --use degit

​
Antigen

Add the following lines to ~/.zshrc. Make sure antigen apply appears after the theme directive:
antigen theme romkatv/powerlevel10k
antigen apply

​
Antibody

Add the following line to ~/.zshrc:
antibody bundle romkatv/powerlevel10k

​
Antidote

Add the following line to ~/.zsh_plugins.txt:
romkatv/powerlevel10k

​
Fallback: Manual Installation When Plugin Manager Setup Fails

If the plugin-manager-specific instructions above did not work, the most reliable fix is to disable any theme your plugin manager is currently loading and then install Powerlevel10k manually. Manual installation does not make anything slower or otherwise sub-par — it is the recommended approach whenever you encounter plugin manager conflicts.
1

Disable the current theme in your plugin manager

Each manager stores the active theme in a different place. Find the entry for your manager below and follow the instruction.Oh My Zsh — Open ~/.zshrc and remove the line that sets ZSH_THEME. It typically looks like:
ZSH_THEME="powerlevel9k/powerlevel9k"
Zplug — Open ~/.zshrc and remove the zplug command that references your current theme. For example:
# remove this line:
zplug bhilburn/powerlevel9k, use:powerlevel9k.zsh-theme
Prezto — Open ~/.zpreztorc and add (or replace any existing theme line with):
zstyle :prezto:module:prompt theme off
Antigen — Open ~/.zshrc and remove the antigen theme line. It typically looks like:
antigen theme powerlevel9k/powerlevel9k
2

Clone Powerlevel10k manually

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/powerlevel10k
3

Source the theme from ~/.zshrc

echo 'source ~/powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc
4

Restart Zsh

exec zsh
The configuration wizard will start automatically on the first launch. You can also trigger it at any time by typing p10k configure.
Users in China can use the official mirror on gitee.com for faster downloads: git clone --depth=1 https://gitee.com/romkatv/powerlevel10k.git ~/powerlevel10k

​
Plugin Unload Hook

For plugin managers that implement a zplugin-style unload mechanism, Powerlevel10k exposes a powerlevel10k_plugin_unload function. Calling this function cleanly removes all prompt customizations made by the theme, allowing your plugin manager to unload it without leaving orphaned state.

​
Pure Style Compatibility

Powerlevel10k can emulate the appearance of the Pure Zsh theme. Run p10k configure and select the Pure style to activate it. You can still use Powerlevel10k-exclusive features such as Instant Prompt and Transient Prompt alongside the Pure appearance.
Powerlevel10k does not recognize Pure’s own configuration parameters. If you are migrating a Pure configuration, you will need to translate your settings to their Powerlevel10k equivalents. For example, replace PURE_CMD_MAX_EXEC_TIME=3 with POWERLEVEL9K_COMMAND_EXECUTION_TIME_THRESHOLD=3. All relevant parameters are documented inside the generated ~/.p10k.zsh file with inline comments.

Build docs developers (and LLMs) love

Get started for freeTalk to us