alien-minimal theme is faster than many other themes.
Why? It updates part of the prompt asynchronously - the time consuming processing like git status checking, git dirty copy checking etc.
How? It starts a background job for these process, and in the mean time shows initial prompt and lets you use the terminal as you would normally.
alien-minimal is independent of any library/framework like Oh-My-Zsh or Prezto.
Add the following line in ~/.zshrc depending on zsh plugin manager
antigen theme eendroroy/alien-minimal alien-minimalzgen:
zgen load eendroroy/alien-minimalzplug "eendroroy/alien-minimal"# if using git 2.13 or higher
git clone --recurse-submodules https://github.com/eendroroy/alien-minimal.git ${ZSH_CUSTOM}/themes/alien-minimal
# if lower version use
cd ${ZSH_CUSTOM}/themes/alien-minimal
git clone https://github.com/eendroroy/alien-minimal.git
git submodule update --init --recursive # --remoteThen set ZSH_THEME="alien-minimal/alien-minimal" in the ~/.zshrc file.
add configurations in ~/.amrc
Enable VI prompt (vi-mode is enabled by bindkey -v)
export AM_ENABLE_VI_PROMPT=1export AM_VI_PROMPT_POS=left_start
# (i) am-demo G:master [1Y,9M] 6fd4c14 @1 + ⭑ ⭑ - - ?
export AM_VI_PROMPT_POS=left_end
# am-demo (i) G:master [1Y,9M] 6fd4c14 @1 + ⭑ ⭑ - - ?
export AM_VI_PROMPT_POS=right_start
# am-demo (i) G:master [1Y,9M] 6fd4c14 @1 + ⭑ ⭑ - - ?
export AM_VI_PROMPT_POS=right_end
# am-demo G:master [1Y,9M] 6fd4c14 @1 + ⭑ ⭑ - - ? (i)export AM_ASYNC_L_PROMPT=1Always show a new line
export AM_INITIAL_LINE_FEED=1Unset AM_INITIAL_LINE_FEED to stop printing a new line.
export AM_PROMPT_START_TAG='-->' # previously `PROMPT_START_TAG`
export AM_PROMPT_END_TAG='\ $' # previously `PROMPT_END_TAG`
export AM_PROMPT_START_TAG_COLOR=81 # previously `PROMPT_START_TAG_COLOR`
export AM_PROMPT_END_TAG_COLOR=81 # previously `PROMPT_END_TAG_COLOR` Result:
--> ~ $
--> ~ $ 1
(venv) --> python-project $
(venv) --> python-project $ 130You can additionally show the error color on prompt start tag:
export AM_ERROR_ON_START_TAG=1Note: if AM_PROMPT_START_TAG is empty, this configuration will be ignored.
Available version are:
PYTHON,PYTHON_S,RUBY,RUBY_S,JAVA,JAVA_S,GO,GO_S,ELIXIR,ELIXIR_S,
CRYSTAL,CRYSTAL_S,NODE,NODE_S,PHP,PHP_S,GRADLE,MAVEN
export AM_VERSIONS_PROMPT=(RUBY PYTHON JAVA GO CRYSTAL NODE PHP ELIXIR GRADLE)Customize Separator:
export AM_VERSION_PROMPT_SEP='|'Note: Prompt maintain declaration order.
export AM_DIR_EXPANSION_LEVEL=2The effect may be un-noticeable on faster CPUs.
export AM_HIDE_EXIT_CODE=1export AM_KEEP_PROMPT=11. export AM_THEME=mono
1. export AM_THEME=mono_bright
1. export AM_THEME=terminal
1. export AM_THEME=soft
1. export AM_THEME=defaultNote: Unset AM_THEME to use default color scheme.
Apart from these default themes, custom colors can be defined:
export AM_VCS_COLOR=1 # color for VCS (G: M: V:)
export AM_SSH_COLOR=11 # color for ssh indicator
export AM_DOCKER_COLOR=12 # color for docker indicator
export AM_NORMAL_COLOR=12 # color for normal text
export AM_ERROR_COLOR=1 # color for ERROR
export AM_REV_COLOR=14 # color for VCS Revision number
export AM_BRANCH_COLOR=10 # color for VCS BRANCH name
export AM_LEFT_RIGHT_COLOR=3 # color for GIT Left-Right status
export AM_STASH_COLOR=3 # color for GIT stash count
export AM_BARE_COLOR=3 # color for GIT bare repo indicator
export AM_COMMIT_SINCE_COLOR=6 # color for last commit time
export AM_FADE_COLOR=8 # color for fade text color
export AM_VENV_COLOR=8 # color fir python virtual env text
export AM_PYTHON_COLOR=2 # color for python version text
export AM_RUBY_COLOR=1 # color for ruby version text
export AM_JAVA_COLOR=15 # color for java version text
export AM_TIMER_COLOR=14 # color for command execution time
export AM_VIINS_COLOR=39 # color for viins mode
export AM_VICMD_COLOR=208 # color vicmd modeOr creating a new theme file:
/path/to/custom/theme.zsh
#!/usr/bin/env zsh
am_theme(){
AM_VCS_COLOR=248
AM_SSH_COLOR=143
AM_DOCKER_COLOR=39
AM_NORMAL_COLOR=39
AM_ERROR_COLOR=208
AM_REV_COLOR=248
AM_BRANCH_COLOR=78
AM_LEFT_RIGHT_COLOR=222
AM_STASH_COLOR=222
AM_BARE_COLOR=222
AM_COMMIT_SINCE_COLOR=244
AM_FADE_COLOR=242
AM_VENV_COLOR=245
AM_PYTHON_COLOR=40
AM_RUBY_COLOR=196
AM_JAVA_COLOR=178
AM_GO_COLOR=81
AM_ELIXIR_COLOR=81
AM_CRYSTAL_COLOR=8
AM_NODE_COLOR=2
AM_PHP_COLOR=5
AM_GRADLE_COLOR=2
AM_MAVEN_COLOR=3
AM_TIMER_COLOR=248
AM_VIINS_COLOR=39
AM_VICMD_COLOR=208
AM_PROMPT_START_TAG_COLOR=39
AM_PROMPT_END_TAG_COLOR=39
AM_GIT_TRACKED_COLOR=78
AM_GIT_UN_TRACKED_COLOR=208
AM_LEFT_RIGHT_COLOR=252
}Then activate the theme using:
export AM_CUSTOM_THEME_PATH=/path/to/custom/theme.zshNerd Font must be installed nerd-fonts
Enable Nerd Font
export AM_USE_NERD_FONT=1 # previously `USE_NERD_FONT`export AM_VIM_INSERT_SYM='(i)'
export AM_VIM_NORMAL_SYM='(n)'
export AM_GIT_STASH_SYM='@'
export AM_GIT_BARE_SYM='☢'
export AM_GIT_SYM='G'
export AM_HG_SYM='H'
export AM_SVN_SYM='S'
export AM_SSH_SYM='[S]'
export AM_DOCKER_SYM='[D]'
export AM_JAVA_SYM='JAVA:'
export AM_PY_SYM='PY:'
export AM_RB_SYM='RB:'
export AM_GO_SYM='GO:'
export AM_ELIXIR_SYM='EX:'
export AM_CRYSTAL_SYM='CR:'
export AM_NODE_SYM='⬡ '
export AM_PHP_SYM='PHP:'
export AM_GRADLE_SYM='GRADLE:'
export AM_MAVEN_SYM='MVN:'
export AM_GIT_REBASING_SYMBOL='⇋'
export AM_GIT_PUSH_SYM='↑'
export AM_GIT_PULL_SYM='↓'
export AM_LEFT_RIGHT_SEP='|'Note: this overrides AM_USE_NERD_FONT configuration.
Bug reports and pull requests are welcome on GitHub at alien-minimal repository. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.
- Fork it ( https://github.com/eendroroy/alien-minimal/fork )
- Create your feature branch (
git checkout -b my-new-feature) - Commit your changes (
git commit -am 'Add some feature') - Push to the branch (
git push origin my-new-feature) - Create a new Pull Request
The project is available as open source under the terms of the MIT License.