1 # Zsh configuration file.
4 source_debug "sourcing ~/.zsh/rc"
6 # MISCELLANEOUS SETTINGS
8 # Use Vi(m) style key bindings.
11 # Be paranoid, new files are readable/writable by me only.
17 # Prevent overwriting existing files with '> filename', use '>| filename'
21 # Entering the name of a directory (if it's not a command) will automatically
22 # cd to that directory.
25 # When entering a nonexistent command name automatically try to find a similar
29 # Enable zsh's extended glob abilities.
32 # Don't exit if <C-d> is pressed.
38 # Make sure every entry in $fpath is unique.
40 # ~/.zsh/functions/completion is a symbolic link to the Completion directory
41 # of a Zsh CVS checkout. Use it to get the newest completions if available.
42 if [[ -d ~/.zsh/functions/completion ]]; then
43 fpath=(~/.zsh/functions/completion/*/*(/) $fpath)
45 # Set correct fpath to allow loading my functions (including completion
47 fpath=(~/.zsh/functions $fpath)
48 # Autoload my functions (except completion functions and hidden files). Thanks
49 # to caphuso from the Zsh example files for this idea.
50 if [[ -d ~/.zsh/functions ]]; then
51 autoload ${fpath[1]}/^_*(^/:t)
54 # Simulate hooks using _functions arrays for Zsh versions older than 4.3.4. At
55 # the moment only precmd() and preexec() are simulated.
57 # At least 4.3.4 (not sure about later versions) has an error in add-zsh-hook
58 # so the compatibility version is used there too.
59 if [[ $ZSH_VERSION != (4.3.<5->|4.<4->*|<5->*) ]]; then
60 # Provide add-zsh-hook which was added in 4.3.4.
61 fpath=(~/.zsh/functions/compatibility $fpath)
63 # Run all functions defined in the ${precmd,preexec}_functions arrays.
65 for function in $precmd_functions; do
70 for function in $preexec_functions; do
76 # Autoload add-zsh-hook to add/remove zsh hook functions easily.
77 autoload -Uz add-zsh-hook
82 # Use history and store it in ~/.zsh/history.
85 HISTFILE=~/.zsh/history
86 # Append to the history file instead of overwriting it and do it immediately
87 # when a command is executed.
89 setopt incappendhistory
90 # If the same command is run multiple times store it only once in the history.
92 # Vim like completions of previous executed commands (also enter Vi-mode). If
93 # called at the beginning it just recalls old commands (like cursor up), if
94 # called after typing something only likes starting with the typed are
95 # returned. Very useful to get old commands quickly. Thanks to Mikachu in #zsh
96 # on Freenode (2010-01-17 12:47) for the information how to a function with
98 zle -N my-vi-history-beginning-search-backward
99 my-vi-history-beginning-search-backward() {
100 local not_at_beginning_of_line
101 if [[ $CURSOR -ne 0 ]]; then
102 not_at_beginning_of_line=yes
105 zle history-beginning-search-backward
107 # Start Vi-mode and stay at the same position (Vi-mode modes one left,
110 if [[ -n $not_at_beginning_of_line ]]; then
114 bindkey "^P" my-vi-history-beginning-search-backward
115 bindkey -a "^P" history-beginning-search-backward # binding for Vi-mode
116 # Here only Vi-mode is necessary as ^P enters Vi-mode and ^N only makes sense
118 bindkey -a "^N" history-beginning-search-forward
123 # Use colorized output, necessary for prompts and completions.
124 autoload -U colors && colors
126 # Set the default prompt. The current host and working directory is displayed,
127 # the exit code of the last command if it wasn't 0, the number of running jobs
128 # if not 0 and a + if this shell is running inside another shell.
129 # The prompt is in green and blue to make easily detectable, the error exit
130 # code in red and bold and the job count in yellow.
131 PROMPT="%{${fg[green]}%}%B%m%b%{${fg[default]}%}:\
132 %{${fg[blue]}%}%B%~%b%{${fg[default]}%} \
133 %(1j.%{${fg[yellow]}%}%j%{${fg[default]}%}.)%(2L.+.)%# \
134 %(?..(%{${fg[red]}%}%B%?%b%{${fg[default]}%}%) )"
136 # VCS_Info was added in 4.3.9 but it works in earlier versions too. So load it
137 # if the necessary files are available in ~/.zsh/functions/vcs_info (often a
138 # symbolic link to current checkout of Zsh's sources).
139 if [[ $ZSH_VERSION == (4.3.<9->|4.<4->*|<5->*) ||
140 -d ~/.zsh/functions/vcs_info ]]; then
141 # Update fpath to allow loading the VCS_Info functions.
142 if [[ -d ~/.zsh/functions/vcs_info ]]; then
143 fpath=(~/.zsh/functions/vcs_info/
144 ~/.zsh/functions/vcs_info/Backends
148 # Allow substitutions and expansions in the prompt, necessary for
151 # Load vcs_info to display information about version control repositories.
152 autoload -Uz vcs_info
153 # Only look for git and mercurial repositories; the only I use.
154 zstyle ':vcs_info:*' enable git hg
155 # Set style of vcs_info display. The current branch (green) and vcs (blue)
156 # is displayed. If there is an special action going on (merge, rebase)
157 # it's also displayed (red).
158 zstyle ':vcs_info:*' formats \
159 "(%{${fg[green]}%}%b%{${fg[default]}%}:\
160 %{${fg[blue]}%}%s%{${fg[default]}%})"
161 zstyle ':vcs_info:*' actionformats \
162 "(%{${fg[green]}%}%b%{${fg[default]}%}/\
163 %{${fg[red]}%}%a%{${fg[default]}%}:\
164 %{${fg[blue]}%}%s%{${fg[default]}%})"
165 # Call vcs_info as precmd before every prompt.
169 add-zsh-hook precmd prompt_precmd
171 # Display the vcs information in the right prompt.
172 if [[ $ZSH_VERSION == (4.3.<9->|4.<4->*|<5->*) ]]; then
173 RPROMPT='${vcs_info_msg_0_}'
174 # There is a bug in Zsh below 4.3.9 which displays a wrong symbol when
175 # ${vcs_info_msg_0_} is empty. Provide a workaround for those versions,
176 # thanks to Frank Terbeck <ft@bewatermyfriend.org> for it.
178 RPROMPT='${vcs_info_msg_0_:- }'
182 # When screen, xterm or rxvt is used set the name of the window to the
183 # currently running program.
185 # When a program is started preexec() sets the window's name to it; when it
186 # stops precmd() resets the window's name to 'zsh'.
188 # It works with screen and xterm. If screen is running in X11 (DISPLAY is set)
189 # and stumpwm is running then the window title is also set in stumpwm using
192 # If a command is run with sudo or if the shell is running as root then a ! is
193 # added at the beginning of the command to make this clear. If a command is
194 # running on a different computer with ssh a @ is added at the beginning. This
195 # only works if the .zshrc on the server also uses this command.
196 if [[ $TERM == screen* || $TERM == xterm* || $TERM == rxvt* ]]; then
197 # Is set to a non empty value to reset the window name in the next
200 # Is set to a non empty value when the stump window manager is running.
201 ps aux | grep -q stumpwm | grep -v grep
202 if [[ $? -eq 0 ]]; then
205 # Is set to a non empty value when the shell is running as root.
206 if [[ $(id -u) -eq 0 ]]; then
211 # Get the program name with its arguments.
212 local program_name=$1
214 # When sudo is used use real program name instead, but with an
215 # exclamation mark at the beginning.
217 if [[ $program_name == sudo* ]]; then
218 program_name=${program_name#sudo }
221 # Remove all arguments from the program name.
222 program_name=${program_name%% *}
224 # Ignore often used commands which are only running for a very short
225 # time. This prevents a "blinking" name when it's changed to "cd" for
226 # example and then some milliseconds later back to "zsh".
227 [[ $program_name == (cd*|ls|la|ll|clear|c) ]] && return
229 # Change my shortcuts so the real name of the program is displayed.
230 case $program_name in
245 # Add an exclamation mark at the beginning if running with sudo or if
246 # running zsh as root.
247 if [[ -n $program_sudo || -n $window_root ]]; then
248 program_name=!$program_name
251 # Add an at mark at the beginning if running through ssh on a
252 # different computer.
253 if [[ -n $SSH_CONNECTION ]]; then
254 program_name="@$program_name"
257 # Set the window name to the currently running program.
258 window_title "$program_name"
260 # Tell precmd() to reset the window name when the program stops.
265 # Abort if no window name reset is necessary.
266 [[ -z $window_reset ]] && return
268 # Reset the window name to 'zsh'.
270 # If the function was called with an argument then reset the window
271 # name to '.zsh' (used by clear alias).
276 # Prepend prefixes like in window_preexec().
277 if [[ -n $SSH_CONNECTION ]]; then
278 window_title "@$name"
279 elif [[ -n $window_root ]]; then
280 window_title "!$name"
285 # Just reset the name, so no screen reset necessary for the moment.
289 # Sets the window title. Works with screen, xterm and rxvt.
291 if [[ $TERM == screen* ]]; then
294 # Update window name in stumpwm if running screen in X11 and when
296 if [[ -n $DISPLAY && -n $window_stumpwm ]]; then
297 echo "$1" | stumpish -e "title" > /dev/null
300 elif [[ $TERM == xterm* || $TERM == rxvt* ]]; then
301 print -n "\e]2;$1\e\\"
305 # Add the preexec() and precmd() hooks.
306 add-zsh-hook preexec window_preexec
307 add-zsh-hook precmd window_precmd
311 # COMPLETION SETTINGS
313 # Load the complist module which provides additions to completion lists
314 # (coloring, scrollable).
315 zmodload zsh/complist
316 # Use new completion system, store dumpfile in ~/.zsh/cache to prevent
318 autoload -U compinit && compinit -d ~/.zsh/cache/zcompdump
320 # Use cache to speed up completions.
321 zstyle ':completion:*' use-cache on
322 zstyle ':completion:*' cache-path ~/.zsh/cache
324 # Complete arguments and fix spelling mistakes when possible.
325 zstyle ':completion:*' completer _complete _match _correct _approximate
327 # Make sure the list of possible completions is displayed after pressing <TAB>
329 setopt nolistambiguous
330 # Allow completions in the middle of a text, i.e. "/usr/bin/<TAB>whatever"
331 # completes like "/usr/bin/<TAB>". Useful when adding new options to commands.
332 bindkey "^I" expand-or-complete-prefix
333 # Try uppercase if the currently typed string doesn't match. This allows
334 # typing in lowercase most of the time and completion fixes the case.
335 zstyle ':completion:*' matcher-list '' 'm:{a-z}={A-Z}'
337 # Use ls like colors for completions.
338 zstyle ':completion:*' list-colors ${(s.:.)LS_COLORS}
340 # Make completion lists scrollable so "do you wish to see all n possibilities"
341 # is no longer displayed.
342 zstyle ':completion:*' list-prompt '%p'
343 # Display group name (like 'external command', 'alias', etc.) when there are
344 # multiple matches in bold.
345 zstyle ':completion:*' format ' %B%d%b:'
346 # Display different types of matches separately.
347 zstyle ':completion:*' group-name ''
349 # Ignore completion functions.
350 zstyle ':completion:*:functions' ignored-patterns '_*'
351 # Ignore parent directory.
352 zstyle ':completion:*:(cd|mv|cp):*' ignore-parents parent pwd
353 # When unsetting variables make sure every variable name is only suggested
355 zstyle ':completion:*:unset:*' ignore-line yes
356 # When working with Mercurial and Git don't complete the same file multiple
357 # times. Very useful when completing file names.
358 zstyle ':completion:*:(hg|git)*:*' ignore-line yes
361 # CUSTOM ALIASES AND FUNCTIONS
363 # If ^C is pressed while typing a command, add it to the history so it can be
364 # easily retrieved later and then abort like ^C normally does. This is useful
365 # when I want to abort an command to do something in between and then finish
366 # typing the command.
368 # Thanks to Vadim Zeitlin <vz-zsh@zeitlins.org> for a fix (--) so lines
369 # starting with - don't cause errors.
371 # Store the current buffer in the history.
372 zle && print -s -- $BUFFER
374 # Return the default exit code so zsh aborts the current command.
378 # Colorize stderr. Very useful when looking for errors. Thanks to
379 # http://gentoo-wiki.com/wiki/Zsh
380 exec 2>>(while read line; do
381 print '\e[91m'${(q)line}'\e[0m' > /dev/tty; print -n $'\0'; done &)
383 # Make sure aliases are expanded when using sudo.
386 # Global aliases for often used commands used in the command line.
388 alias -g L='E | less'
389 alias -g D='E | colordiff L'
394 # Make going up directories simple.
396 alias -g ....='../../..'
397 alias -g .....='../../../..'
399 # Shortcuts for often used programs.
407 # Improved ls which displays the files in columns (-C), visualizes
408 # directories, links and other special files (-F) and pages everything through
411 # If available use GNU ls with colorized output. If it isn't available use
412 # normal ls which needs CLICOLOR_FORCE so it displays colors when used with a
414 ls --color &> /dev/null
415 if [[ $? -eq 0 ]]; then
416 alias ls='ls --color'
418 alias ls='CLICOLOR_FORCE=1 ls -G'
422 command ls -C -F $* L
424 # Helper function to list all files.
428 # Helper function to list all files in list format with access rights, etc.
433 # If the window naming feature is used (see above) then use ".zsh" (leading
434 # dot) as title name after running clear so it's clear to me that the window
435 # is empty. I open so much windows that I don't know in which I have something
436 # important. This helps me to remember which windows are empty (I run clear
437 # after I finished my work in a window).
438 if [[ -n $window_reset ]]; then
439 alias clear='clear; window_reset=yes; window_precmd reset'
442 # I sometimes confuse editor and shell, print a warning to prevent I exit the
444 alias :q='echo "This is not Vim!" >&2'
446 # Automatically use unified diffs.
449 # Display all files and use human readable sizes.
452 # Use human readable sizes.
455 # Edit the mercurial patch queue series file for the current mercurial
456 # repository in Vim. Also change Vim's pwd to the patches directory so other
457 # patches can easily be opened.
458 alias vqs='vim -c "cd $(hg root)/.hg/patches/" "$(hg root)/.hg/patches/series"'
460 # Display all branches (except stash) in gitk but only 200 commits as this is
461 # much faster. Also put in the background and disown. Thanks to sitaram in
462 # #git on Freenode (2009-04-20 15:51).
466 $(git rev-parse --symbolic-full-name --remotes --branches) \
470 # Same for tig (except the disown part as it's no GUI program).
474 $(git rev-parse --symbolic-full-name --remotes --branches) \
481 # If not already in screen reattach to a running session or create a new one.
483 # screen* is necessary as `screen` uses screen.linux for example for a linux
484 # console which would otherwise cause an infinite loop.
485 if [[ $TERM != screen* && $TERM != 'dumb' ]]; then
486 # Get running detached sessions.
487 session=$(screen -list | grep 'Detached' | awk '{ print $1; exit }')
488 # Create a new session if none is running.
489 if [[ -z $session ]]; then
491 # Reattach to a running session.
498 # Load rc file for current OS.
499 source_config ~/.zsh os rc $(uname) nolocal
500 # Load rc file for current hostname (first part before a dot) or rc.local.
501 source_config ~/.zsh host rc ${$(hostname)//.*/}
503 source_debug "finished sourcing ~/.zsh/rc"