Dotfiles

Configuration for Fish, Starship, TMUX, Neovim and development tools.

Works on macOS (Homebrew) and Fedora/Bluefin (DNF).

Installation

git clone https://github.com/USERNAME/dotfiles.git ~/dotfiles
cd ~/dotfiles
./install.sh

The script installs just if missing and runs the full installation.

Per-component installation

just install-fish         # Fish shell
just install-starship     # Prompt
just install-tmux         # Terminal multiplexer
just install-nvim         # Neovim (symlink)
just install-gitconfig    # Git with delta
just install-lazygit      # Lazygit

Coding agents

just install-claude       # Claude Code
just install-codex        # Codex CLI
just install-aichat       # AIChat
just install-coding-agents # All

Preview and backups

just check-changes              # Preview changes without applying
DRY_RUN=1 just install-fish     # Dry-run a component
just diff-config tmux           # Diff specific config
just list-backups               # List backups
just restore-backup fish <ts>   # Restore backup

Backups are created automatically in ~/.config-backups/.

Structure

fish/
  config.fish              # Main config
  conf.d/                  # Auto-loaded
    aliases.fish
    abbreviations.fish
    integrations.fish      # fzf, zoxide, starship
    tmux.fish
    workspaces.fish
  functions/               # Custom functions

nvim/                      # LazyVim config (symlink to ~/.config/nvim)
tmux.conf                  # TMUX config
starship.toml              # Prompt config
git/config                 # Git config with delta
lazygit/                   # Lazygit config
aichat/                    # AIChat config
claude/                    # Claude Code settings
codex/                     # Codex CLI config
code/                      # VSCode settings
zed/                       # Zed editor settings
cli.Brewfile               # Homebrew packages

Fish shell

Set as default shell:

echo $(which fish) | sudo tee -a /etc/shells
chsh -s $(which fish)

Zed Remote fish handoff

Zed remote terminals can start the platform login shell before applying the configured fish shell. These dotfiles set terminal.env.ZED_WANTS_FISH=1 in Zed and install a shared hook for zsh and bash:

• macOS/zsh: .zshenv sources ~/.config/shell/zed-fish-shell-hook.sh.
• Linux/bash: .bashrc and .bash_profile source the same hook, and Zed sets BASH_ENV=${HOME}/.config/shell/zed-fish-shell-hook.sh for non-interactive bash launches.

The hook uses ZED_FISH_LAUNCHED to avoid loops and falls back to common fish paths on macOS and Linux when fish is not already on PATH.

Useful abbreviations (expand with space):

• g -> git
• ga -> git add
• gc -> git commit
• gp -> git push

TMUX

Prefix: Ctrl-a

Main shortcuts:

• Ctrl-a | vertical split
• Ctrl-a - horizontal split
• Ctrl-a z zoom pane
• Click to switch panes

Fish functions:

• ta <session> attach
• ts <name> new session
• tl list sessions

CLI tools

See cli.Brewfile for full list. Install with:

just install-brew-essential-cli-packages

Main tools: bat, eza, fd, ripgrep, fzf, zoxide, lazygit, gh, btop.

Verify installation

just check           # Check dependencies and configs
just check-deps      # Dependencies only

Update

just update          # Everything
just update-nvim     # Neovim plugins only