zsh Configuration
=================

zsh shell configuration - my primary shell with autosuggestions, syntax highlighting, and custom functions

Date: February 7, 2026


zsh is my primary shell, configured for productivity with autosuggestions,
syntax highlighting, and a custom prompt.

## Features

- **zsh-autosuggestions** - Fish-like suggestions as you type
- **zsh-syntax-highlighting** - Command validation as you type
- **Starship prompt** - Fast, customizable prompt with git info
- **fzf integration** - Fuzzy completion and history search
- **Atuin** - Enhanced shell history with sync

## Setup

### Installation

zsh should be installed via your package manager:

```bash
# Ubuntu/Debian
sudo apt install zsh

# Arch Linux
sudo pacman -S zsh

# macOS
brew install zsh
```

Make zsh your default shell:

```bash
chsh -s $(which zsh)
```

### Configuration

The main config file is `~/.zshrc`. Key sections include:

#### Path Management

```zsh
export PATH="$HOME/.local/bin:$PATH"
export PATH="$HOME/.cargo/bin:$PATH"
export PATH="$HOME/go/bin:$PATH"
```

#### Tool Activation

```zsh
# mise (tool manager)
eval "$(~/.local/bin/mise activate zsh)"

# starship prompt
eval "$(starship init zsh)"

# atuin history
eval "$(atuin init zsh)"

# direnv
eval "$(direnv hook zsh)"
```

#### Plugins

```zsh
# These provide suggestions and highlighting
source ~/.zsh/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh
source ~/.zsh/plugins/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh
source ~/.zsh/plugins/zsh-history-substring-search/zsh-history-substring-search.zsh
```

## Custom Functions

### web2app

Create desktop web app launchers:

```zsh
web2app "GitHub" "https://github.com" "https://icon-url.png"
```

### Browser Detection

Automatically detects your default browser from desktop files:

```zsh
# Falls back through: brave, chromium, google-chrome, firefox
echo $BROWSER
```

## History Configuration

Extended history with sharing between sessions:

```zsh
HISTFILESIZE=1000000000
HISTSIZE=1000000000
SAVEHIST=1000000000
setopt appendhistory
setopt share_history
```

## Key Bindings

| Key | Action |
|-----|--------|
| `Ctrl+E` | Edit command in $EDITOR |
| `Ctrl+K` | Clear screen and run wfetch |
| `Ctrl+N` | Expand alias |
| `Ctrl+P` | List all commands with fzf |
| `Ctrl+G` | Open gitui |
| `Up/Down` | History search by prefix |

## Completion

Advanced completion with:

- Case-insensitive matching
- Fuzzy matching
- Menu selection with arrow keys
- Grouped results with descriptions

## See Also

<div class="embed-card">
  <a href="/starship/" class="embed-card-link">
    <div class="embed-card-content">
      <div class="embed-card-title">Starship Prompt</div>
      <div class="embed-card-description">Starship - minimal, fast, and customizable shell prompt</div>
      <div class="embed-card-meta">Feb 7, 2026</div>
    </div>
  </a>
</div>


<div class="embed-card">
  <a href="/atuin/" class="embed-card-link">
    <div class="embed-card-content">
      <div class="embed-card-title">Atuin</div>
      <div class="embed-card-description">Atuin - a magical shell history with sync</div>
      <div class="embed-card-meta">Feb 7, 2026</div>
    </div>
  </a>
</div>


<div class="embed-card">
  <a href="/mise/" class="embed-card-link">
    <div class="embed-card-content">
      <div class="embed-card-title">mise Tool Management</div>
      <div class="embed-card-description">mise - the universal version manager for development tools</div>
      <div class="embed-card-meta">Feb 7, 2026</div>
    </div>
  </a>
</div>


<div class="embed-card embed-card-external">
  <a href="https://zsh.sourceforge.io/Doc/" class="embed-card-link" target="_blank" rel="noopener noreferrer">
    <div class="embed-card-content">
      <div class="embed-card-title">ZSH - Documentation</div>
      <div class="embed-card-meta">zsh.sourceforge.io</div>
    </div>
  </a>
</div>