romkatv/powerlevel10k

Maintainer? Show your league in your README

Card: your league's emblem, from Copper to Legendary

[![bestofgithub](https://bestofgithub.dev/badge/romkatv/powerlevel10k.svg?style=card)](https://bestofgithub.dev/repo/romkatv/powerlevel10k)

Flat: fits beside your other badges

[![bestofgithub](https://bestofgithub.dev/badge/romkatv/powerlevel10k.svg)](https://bestofgithub.dev/repo/romkatv/powerlevel10k)

Loading README…

Command	Prompt Indicator	Meaning
`timew start hack linux`	`⌚ hack linux`	time tracking enabled in timewarrior
`touch x y`	`?2`	2 untracked files in the Git repo
`rm COPYING`	`!1`	1 unstaged change in the Git repo
`echo 3.7.3 >.python-version`	`🐍 3.7.3`	the current python version in pyenv

Segment	Meaning
`anaconda`	virtual environment from conda
`asdf`	tool versions from asdf
`aws`	aws profile
`aws_eb_env`	aws elastic beanstalk environment
`azure`	azure account name
`background_jobs`	presence of background jobs
`battery`	internal battery state and charge level (yep, batteries literally included)
`command_execution_time`	duration (wall time) of the last command
`context`	user@hostname
`cpu_arch`	CPU architecture
`dir`	current working directory
`direnv`	direnv status
`disk_usage`	disk usage
`dotnet_version`	dotnet version
`fvm`	flutter environment from fvm
`gcloud`	google cloud cli account and project
`goenv`	go environment from goenv
`google_app_cred`	google application credentials
`go_version`	go version
`haskell_stack`	haskell version from stack
`ip`	IP address and bandwidth usage for a specified network interface
`java_version`	java version
`jenv`	java environment from jenv
`kubecontext`	current kubernetes context
`laravel_version`	laravel php framework version
`load`	CPU load
`luaenv`	lua environment from luaenv
`midnight_commander`	midnight commander shell
`nix_shell`	nix shell indicator
`nnn`	nnn shell
`lf`	lf shell
`chezmoi_shell`	chezmoi shell
`nodeenv`	node.js environment from nodeenv
`nodenv`	node.js environment from nodenv
`node_version`	node.js version
`nordvpn`	nordvpn connection status
`nvm`	node.js environment from nvm
`os_icon`	your OS logo (apple for macOS, swirl for debian, etc.)
`package`	`name@version` from package.json
`per_directory_history`	Oh My Zsh per-directory-history local/global indicator
`perlbrew`	perl version from perlbrew
`phpenv`	php environment from phpenv
`php_version`	php version
`plenv`	perl environment from plenv
`prompt_char`	multi-functional prompt symbol; changes depending on vi mode: `❯`, `❮`, `V`, `▶` for insert, command, visual and replace mode respectively; turns red on error
`proxy`	system-wide http/https/ftp proxy
`public_ip`	public IP address
`pyenv`	python environment from pyenv
`ram`	free RAM
`ranger`	ranger shell
`yazi`	yazi shell
`rbenv`	ruby environment from rbenv
`rust_version`	rustc version
`rvm`	ruby environment from rvm
`scalaenv`	scala version from scalaenv
`status`	exit code of the last command
`swap`	used swap
`taskwarrior`	taskwarrior task count
`terraform`	terraform workspace
`terraform_version`	terraform version
`time`	current time
`timewarrior`	timewarrior tracking status
`todo`	todo items
`toolbox`	toolbox name
`vcs`	Git repository status
`vim_shell`	vim shell (`:sh`)
`virtualenv`	python environment from venv
`vi_mode`	vi mode (you don't need this if you've enabled prompt_char)
`vpn_ip`	virtual private network indicator
`wifi`	WiFi speed
`xplr`	xplr shell

Installation	Update command
Manual	`git -C ~/powerlevel10k pull`
Oh My Zsh	`git -C "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k" pull`
Prezto	`zprezto-update`
Zim	`zimfw update`
Antigen	`antigen update`
Antidote	`antidote update`
Zplug	`zplug update`
Zgen	`zgen update`
Zplugin	`zplugin update`
Zinit	`zinit update`
Zi	`zi update`
Zap	`zap update`
Homebrew	`brew update && brew upgrade`
Arch Linux	`yay -S --noconfirm zsh-theme-powerlevel10k-git`
Alpine Linux	`apk update && apk upgrade`

Installation	Uninstall command
Manual	`rm -rf ~/powerlevel10k`
Oh My Zsh	`rm -rf -- "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k"`
Prezto	n/a
Zim	`zimfw uninstall`
Antigen	`antigen purge romkatv/powerlevel10k`
Antidote	`antidote purge romkatv/powerlevel10k`
Zplug	`zplug clean`
Zgen	`zgen reset`
Zplugin	`zplugin delete romkatv/powerlevel10k`
Zinit	`zinit delete romkatv/powerlevel10k`
Zi	`zi delete romkatv/powerlevel10k`
Zap	`zsh -ic 'zap clean'`
Homebrew	`brew uninstall powerlevel10k`
Arch Linux	`yay -R --noconfirm zsh-theme-powerlevel10k-git`
Alpine Linux	`apk del zsh-theme-powerlevel10k`

Symbol	Meaning	Source
`feature`	current branch; replaced with `#tag` or `@commit` if not on a branch	`git status --ignore-submodules=dirty`
`master`	remote tracking branch; only shown if different from local branch	`git rev-parse --abbrev-ref --symbolic-full-name @{upstream}`
`wip`	the latest commit's summary contains "wip" or "WIP"	`git show --pretty=%s --no-patch HEAD`
`=`	up to date with the remote (neither ahead nor behind)	`git rev-list --count HEAD...@{upstream}`
`⇣42`	this many commits behind the remote	`git rev-list --right-only --count HEAD...@{upstream}`
`⇡42`	this many commits ahead of the remote	`git rev-list --left-only --count HEAD...@{upstream}`
`⇠42`	this many commits behind the push remote	`git rev-list --right-only --count HEAD...@{push}`
`⇢42`	this many commits ahead of the push remote	`git rev-list --left-only --count HEAD...@{push}`
`*42`	this many stashes	`git stash list`
`merge`	repository state	`git status --ignore-submodules=dirty`
`~42`	this many merge conflicts	`git status --ignore-submodules=dirty`
`+42`	this many staged changes	`git status --ignore-submodules=dirty`
`!42`	this many unstaged changes	`git status --ignore-submodules=dirty`
`?42`	this many untracked files	`git status --ignore-submodules=dirty`
`─`	the number of staged, unstaged or untracked files is unknown	`echo $POWERLEVEL9K_VCS_MAX_INDEX_SIZE_DIRTY` or `git config --get bash.showDirtyState`

Powerlevel10k

Getting started

Features

Configuration wizard

Uncompromising performance

Powerlevel9k compatibility

Pure compatibility

Instant prompt

Show on command

Transient prompt

Current directory that just works

Extremely customizable

Batteries included

Extensible

Installation

Manual

Oh My Zsh

Prezto

Zim

Antibody

Antidote

Antigen

Zplug

Zgen

Zplugin

Zinit

Zi

Zap

Homebrew

Arch Linux

Alpine Linux

Fig

Configuration

For new users

For Powerlevel9k users

Fonts

Meslo Nerd Font patched for Powerlevel10k

Automatic font installation

Manual font installation

Try it in Docker

License

FAQ

How do I update Powerlevel10k?

How do I uninstall Powerlevel10k?

How do I install Powerlevel10k on a machine without Internet access?

Where can I ask for help and report bugs?

Which aspects of shell and terminal does Powerlevel10k affect?

I'm using Powerlevel9k with Oh My Zsh. How do I migrate?

Is it really fast?

How do I configure instant prompt?

How do I initialize direnv when using instant prompt?

How do I export GPG_TTY when using instant prompt?

What do different symbols in Git status mean?

How do I change the format of Git status?

Why is Git status from $HOME/.git not displayed in prompt?

Why does Git status sometimes appear grey and then gets colored after a short period of time?

How do I add username and/or hostname to prompt?

Why some prompt segments appear and disappear as I'm typing?

How do I change prompt colors?

Change the color palette used by your terminal

Set colors through Powerlevel10k configuration parameters

Why does Powerlevel10k spawn extra processes?

Are there configuration options that make Powerlevel10k slow?

Is Powerlevel10k fast to load?

What is the relationship between Powerlevel9k and Powerlevel10k?

Does Powerlevel10k always render exactly the same prompt as Powerlevel9k given the same config?

What is the best prompt style in the configuration wizard?

How to make Powerlevel10k look like robbyrussell Oh My Zsh theme?

Can prompts for completed commands display error status for those commands instead of the commands preceding them?

What is the minimum supported Zsh version?

How were these screenshots and animated gifs created?

How was the recommended font created?

How to package Powerlevel10k for distribution?

Troubleshooting

[oh-my-zsh] theme 'powerlevel10k/powerlevel10k' not found

Question mark in prompt

Icons, glyphs or powerline symbols don't render

Sub-pixel imperfections around powerline symbols

Error: character not in range

Cursor is in the wrong place

Why is Git status from `$HOME/.git` not displayed in prompt?

`[oh-my-zsh] theme 'powerlevel10k/powerlevel10k' not found`

Weird things happen after typing `source ~/.zshrc`