Automated Zsh Setup: Complete Installation and Configuration#

1
# Enhanced .zshrc with additional functionality
2
cat > "$HOME/.zshrc" << 'EOL'
3
# Path to plugins
4
PLUGIN_DIR="$HOME/.local/share/zsh-plugins"
5

6
# History configuration
7
HISTFILE="$HOME/.zsh_history"
8
HISTSIZE=50000
9
SAVEHIST=50000
10
setopt HIST_IGNORE_ALL_DUPS
11
setopt HIST_FIND_NO_DUPS
12
setopt INC_APPEND_HISTORY
13
setopt SHARE_HISTORY
14
setopt HIST_REDUCE_BLANKS
15
setopt HIST_VERIFY
16

17
# Shell options
18
setopt AUTO_CD
19
setopt AUTO_PUSHD
20
setopt PUSHD_IGNORE_DUPS
21
setopt INTERACTIVE_COMMENTS
22
setopt EXTENDED_GLOB
23
setopt CORRECT
24
setopt PROMPT_SUBST
25

26
# Completion system
27
autoload -Uz compinit
28
compinit -d ~/.cache/zsh/zcompdump-$ZSH_VERSION
29

30
# Completion styling
31
zstyle ':completion:*' menu select
32
zstyle ':completion:*' matcher-list 'm:{a-zA-Z}={A-Za-z}' 'r:|=*' 'l:|=* r:|=*'
33
zstyle ':completion:*' list-colors "${(s.:.)LS_COLORS}"
34
zstyle ':completion:*:descriptions' format '[%d]'
35
zstyle ':completion:*:warnings' format 'No matches found'
36
zstyle ':completion:*' group-name ''
37
zstyle ':completion:*' verbose yes
38
_comp_options+=(globdots)
39

40
# Load plugins with error handling
41
load_plugin() {
42
    local plugin_path="$1"
43
    if [[ -f "$plugin_path" ]]; then
44
        source "$plugin_path"
45
    else
46
        echo "Warning: Plugin not found at $plugin_path"
47
    fi
48
}
49

50
load_plugin "$PLUGIN_DIR/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"
51
load_plugin "$PLUGIN_DIR/zsh-autosuggestions/zsh-autosuggestions.zsh"
52
load_plugin "$PLUGIN_DIR/zsh-completions/zsh-completions.plugin.zsh"
53
load_plugin "$PLUGIN_DIR/zsh-history-substring-search/zsh-history-substring-search.zsh"
54

55
# Plugin configuration
56
ZSH_AUTOSUGGEST_STRATEGY=(history completion)
57
ZSH_AUTOSUGGEST_BUFFER_MAX_SIZE=20
58
ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE="fg=#666666"
59

60
# Enhanced aliases
61
alias ls='exa --icons --group-directories-first'
62
alias ll='exa -l --icons --group-directories-first --time-style=long-iso'
63
alias la='exa -la --icons --group-directories-first --time-style=long-iso'
64
alias tree='exa --tree --icons --level=3'
65
alias treea='exa --tree --icons -a --level=3'
66

67
# Better cat with syntax highlighting
68
alias cat='bat --style=plain --paging=never'
69
alias less='bat --style=plain'
70

71
# Directory navigation
72
alias ..='cd ..'
73
alias ...='cd ../..'
74
alias ....='cd ../../..'
75
alias .....='cd ../../../..'
76

77
# Git aliases
78
alias gs='git status'
79
alias ga='git add'
80
alias gaa='git add --all'
81
alias gc='git commit'
82
alias gcm='git commit -m'
83
alias gp='git push'
84
alias gpl='git pull'
85
alias gco='git checkout'
86
alias gb='git branch'
87
alias gd='git diff'
88
alias gl='git log --oneline --graph --decorate'
89

90
# System aliases
91
alias grep='grep --color=auto'
92
alias egrep='egrep --color=auto'
93
alias fgrep='fgrep --color=auto'
94
alias df='df -h'
95
alias du='du -h'
96
alias free='free -h'
97
alias ps='ps aux'
98
alias top='htop'
99

100
# Network aliases
101
alias ping='ping -c 5'
102
alias ports='netstat -tulanp'
103
alias myip='curl -s https://ifconfig.me'
104

105
# Custom functions
106
mkcd() {
107
    mkdir -p "$1" && cd "$1"
108
}
109

110
extract() {
111
    if [ -f "$1" ] ; then
112
        case "$1" in
113
            *.tar.bz2)   tar xjf "$1"     ;;
114
            *.tar.gz)    tar xzf "$1"     ;;
115
            *.bz2)       bunzip2 "$1"     ;;
116
            *.rar)       unrar x "$1"     ;;
117
            *.gz)        gunzip "$1"      ;;
118
            *.tar)       tar xf "$1"      ;;
119
            *.tbz2)      tar xjf "$1"     ;;
120
            *.tgz)       tar xzf "$1"     ;;
121
            *.zip)       unzip "$1"       ;;
122
            *.Z)         uncompress "$1"  ;;
123
            *.7z)        7z x "$1"        ;;
124
            *)           echo "'$1' cannot be extracted via extract()" ;;
125
        esac
126
    else
127
        echo "'$1' is not a valid file"
128
    fi
129
}
130

131
# FZF integration
132
if command -v fzf &> /dev/null; then
133
    # FZF key bindings
134
    if [[ -f /usr/share/fzf/key-bindings.zsh ]]; then
135
        source /usr/share/fzf/key-bindings.zsh
136
    elif [[ -f ~/.fzf/shell/key-bindings.zsh ]]; then
137
        source ~/.fzf/shell/key-bindings.zsh
138
    fi
139

140
    # FZF completion
141
    if [[ -f /usr/share/fzf/completion.zsh ]]; then
142
        source /usr/share/fzf/completion.zsh
143
    elif [[ -f ~/.fzf/shell/completion.zsh ]]; then
144
        source ~/.fzf/shell/completion.zsh
145
    fi
146

147
    # FZF configuration
148
    export FZF_DEFAULT_COMMAND='rg --files --hidden --follow --glob "!.git/*"'
149
    export FZF_DEFAULT_OPTS='
150
        --height 40%
151
        --layout=reverse
152
        --border
153
        --preview "bat --color=always --style=header,grid --line-range :300 {}"
154
        --preview-window=right:60%:wrap
155
    '
156
    export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"
157
    export FZF_ALT_C_COMMAND="find . -type d"
158
fi
159

160
# Enhanced keybindings
161
bindkey '^[[A' history-substring-search-up
162
bindkey '^[[B' history-substring-search-down
163
bindkey '^[[H' beginning-of-line
164
bindkey '^[[F' end-of-line
165
bindkey '^[[3~' delete-char
166
bindkey '^[[1;5C' forward-word
167
bindkey '^[[1;5D' backward-word
168
bindkey '^R' fzf-history-widget
169
bindkey '^T' fzf-file-widget
170
bindkey '^[c' fzf-cd-widget
171

172
# Initialize starship prompt
173
if command -v starship &> /dev/null; then
174
    eval "$(starship init zsh)"
175
else
176
    # Fallback prompt if starship is not available
177
    autoload -Uz vcs_info
178
    precmd() { vcs_info }
179
    zstyle ':vcs_info:git:*' formats '(%b)'
180
    setopt PROMPT_SUBST
181
    PROMPT='%F{cyan}%n@%m%f:%F{blue}%~%f%F{red}${vcs_info_msg_0_}%f$ '
182
fi
183

184
# Environment variables
185
export EDITOR='vim'
186
export BROWSER='firefox'
187
export PAGER='less'
188
export LANG='en_US.UTF-8'
189
export LC_ALL='en_US.UTF-8'
190

191
# Add local bin to PATH
192
export PATH="$HOME/.local/bin:$HOME/bin:$PATH"
193

194
# Load local configurations if they exist
195
[[ -f ~/.zshrc.local ]] && source ~/.zshrc.local
196
EOL

1
# Plugin management functions for .zshrc
2
zsh_add_plugin() {
3
    local plugin_name="$1"
4
    local plugin_repo="$2"
5
    local plugin_dir="$PLUGIN_DIR/$plugin_name"
6

7
    if [[ ! -d "$plugin_dir" ]]; then
8
        echo "Installing plugin: $plugin_name"
9
        git clone --depth 1 "$plugin_repo" "$plugin_dir"
10
    fi
11

12
    # Source the plugin
13
    for init_file in "$plugin_dir"/{*.plugin.zsh,*.zsh,init.zsh}; do
14
        [[ -f "$init_file" ]] && source "$init_file" && break
15
    done
16
}
17

18
zsh_update_plugins() {
19
    echo "Updating Zsh plugins..."
20
    for plugin_dir in "$PLUGIN_DIR"/*; do
21
        if [[ -d "$plugin_dir/.git" ]]; then
22
            echo "Updating $(basename "$plugin_dir")"
23
            (cd "$plugin_dir" && git pull)
24
        fi
25
    done
26
}
27

28
# Usage examples
29
# zsh_add_plugin "fast-syntax-highlighting" "https://github.com/zdharma/fast-syntax-highlighting"
30
# zsh_add_plugin "zsh-autosuggestions" "https://github.com/zsh-users/zsh-autosuggestions"

1
# Custom theme functions
2
load_custom_theme() {
3
    local theme_name="$1"
4
    local theme_file="$HOME/.config/zsh/themes/$theme_name.zsh"
5

6
    if [[ -f "$theme_file" ]]; then
7
        source "$theme_file"
8
    else
9
        echo "Theme not found: $theme_name"
10
    fi
11
}
12

13
# Create custom prompt theme
14
create_minimal_prompt() {
15
    autoload -Uz vcs_info
16
    precmd() { vcs_info }
17

18
    zstyle ':vcs_info:git:*' formats ' (%b)'
19
    zstyle ':vcs_info:*' enable git
20

21
    setopt PROMPT_SUBST
22
    PROMPT='%F{blue}%~%f%F{red}${vcs_info_msg_0_}%f %F{green}❯%f '
23
    RPROMPT='%F{yellow}%D{%H:%M}%f'
24
}

1
# Security-focused installation checks
2
verify_package_integrity() {
3
    local package="$1"
4

5
    # Check if package is signed (Arch Linux)
6
    if command -v pacman &> /dev/null; then
7
        pacman -Qi "$package" | grep -q "Validated By.*Signature"
8
        return $?
9
    fi
10

11
    # Check if package is from official repositories (Debian/Ubuntu)
12
    if command -v apt &> /dev/null; then
13
        apt-cache policy "$package" | grep -q "500 http://archive.ubuntu.com"
14
        return $?
15
    fi
16

17
    return 1
18
}
19

20
# Validate plugin sources
21
validate_plugin_source() {
22
    local plugin_repo="$1"
23

24
    # Only allow GitHub repositories from trusted organizations
25
    if [[ "$plugin_repo" =~ ^https://github\.com/(zsh-users|ohmyzsh|romkatv)/ ]]; then
26
        return 0
27
    else
28
        echo "Warning: Untrusted plugin source: $plugin_repo"
29
        return 1
30
    fi
31
}
32

33
# Secure plugin installation
34
secure_plugin_install() {
35
    local plugin_name="$1"
36
    local plugin_repo="$2"
37

38
    if validate_plugin_source "$plugin_repo"; then
39
        git clone --depth 1 "$plugin_repo" "$PLUGIN_DIR/$plugin_name"
40

41
        # Verify no executable files in unexpected locations
42
        find "$PLUGIN_DIR/$plugin_name" -type f -executable | while read -r file; do
43
            echo "Warning: Executable file found: $file"
44
        done
45
    else
46
        echo "Plugin installation blocked for security reasons"
47
        return 1
48
    fi
49
}

1
# Configuration validation functions
2
validate_zshrc() {
3
    local zshrc_file="$1"
4

5
    # Check for dangerous commands
6
    local dangerous_patterns=(
7
        "rm -rf /"
8
        "sudo.*passwd"
9
        "chmod 777"
10
        "curl.*|.*sh"
11
        "wget.*|.*sh"
12
    )
13

14
    for pattern in "${dangerous_patterns[@]}"; do
15
        if grep -qE "$pattern" "$zshrc_file"; then
16
            echo "Warning: Potentially dangerous pattern found: $pattern"
17
            return 1
18
        fi
19
    done
20

21
    # Syntax check
22
    zsh -n "$zshrc_file" 2>/dev/null
23
    return $?
24
}
25

26
# Backup verification
27
verify_backup() {
28
    local original="$1"
29
    local backup="$2"
30

31
    if [[ -f "$backup" ]]; then
32
        if diff "$original" "$backup" >/dev/null 2>&1; then
33
            echo "Backup verified: $backup"
34
            return 0
35
        else
36
            echo "Warning: Backup differs from original"
37
            return 1
38
        fi
39
    else
40
        echo "Warning: Backup not found: $backup"
41
        return 1
42
    fi
43
}

1
# Troubleshooting script
2
diagnose_zsh_setup() {
3
    echo "=== Zsh Setup Diagnostics ==="
4

5
    # Check Zsh installation
6
    if command -v zsh &> /dev/null; then
7
        echo "✓ Zsh is installed: $(zsh --version)"
8
    else
9
        echo "✗ Zsh is not installed"
10
        return 1
11
    fi
12

13
    # Check current shell
14
    if [[ "$SHELL" == *"zsh"* ]]; then
15
        echo "✓ Current shell is Zsh"
16
    else
17
        echo "⚠ Current shell is not Zsh: $SHELL"
18
        echo "  Run: chsh -s $(which zsh)"
19
    fi
20

21
    # Check .zshrc
22
    if [[ -f "$HOME/.zshrc" ]]; then
23
        echo "✓ .zshrc exists"
24

25
        # Syntax check
26
        if zsh -n "$HOME/.zshrc" 2>/dev/null; then
27
            echo "✓ .zshrc syntax is valid"
28
        else
29
            echo "✗ .zshrc has syntax errors"
30
            zsh -n "$HOME/.zshrc"
31
        fi
32
    else
33
        echo "✗ .zshrc not found"
34
    fi
35

36
    # Check plugins
37
    local plugin_dir="$HOME/.local/share/zsh-plugins"
38
    if [[ -d "$plugin_dir" ]]; then
39
        echo "✓ Plugin directory exists"
40
        echo "  Installed plugins:"
41
        ls "$plugin_dir" | sed 's/^/    /'
42
    else
43
        echo "✗ Plugin directory not found"
44
    fi
45

46
    # Check Starship
47
    if command -v starship &> /dev/null; then
48
        echo "✓ Starship is installed: $(starship --version)"
49
    else
50
        echo "⚠ Starship is not installed"
51
    fi
52

53
    # Check dependencies
54
    local deps=("git" "curl" "exa" "bat" "fzf" "rg")
55
    for dep in "${deps[@]}"; do
56
        if command -v "$dep" &> /dev/null; then
57
            echo "✓ $dep is available"
58
        else
59
            echo "⚠ $dep is not installed"
60
        fi
61
    done
62
}
63

64
# Performance diagnostics
65
check_zsh_performance() {
66
    echo "=== Zsh Performance Check ==="
67

68
    # Measure startup time
69
    local startup_time
70
    startup_time=$(time (zsh -i -c exit) 2>&1 | grep real | awk '{print $2}')
71
    echo "Startup time: $startup_time"
72

73
    # Check for slow plugins
74
    echo "Profiling plugins..."
75
    zsh -i -c 'for plugin in $PLUGIN_DIR/*/*.zsh; do
76
        echo "Testing: $(basename $plugin)"
77
        time source "$plugin" 2>/dev/null
78
    done'
79
}
80

81
# Plugin issues
82
fix_plugin_issues() {
83
    echo "=== Fixing Plugin Issues ==="
84

85
    local plugin_dir="$HOME/.local/share/zsh-plugins"
86

87
    # Check plugin permissions
88
    find "$plugin_dir" -type f -name "*.zsh" ! -perm 644 | while read -r file; do
89
        echo "Fixing permissions for: $file"
90
        chmod 644 "$file"
91
    done
92

93
    # Update plugins
94
    for plugin in "$plugin_dir"/*; do
95
        if [[ -d "$plugin/.git" ]]; then
96
            echo "Updating: $(basename "$plugin")"
97
            (cd "$plugin" && git pull --quiet)
98
        fi
99
    done
100
}