neovimcraft

plugins configs about

CREATED

2023-09-22

UPDATED

2026-08-06

WizardStark's dotfiles

This is a collection of configuration files for the tools that I like to use during software development: Neovim, Tmux (not so much anymore due to Neovide and my homegrown session management), Alacritty.

Dotfile management

This project uses GNU Stow to create symlinks from this repository to your $HOME directory.

Setup

NOTE:

This script will ask for sudo permissions, which are then used for brew and apt (if applicable) installs
This script will create symlinks to ~/.zshrc, ~/.config/nvim and ~/.config/tmux, see GNU Stow for how conflicts will be handled

git clone https://github.com/WizardStark/dotfiles.git
cd dotfiles
./setup.sh

Syncing an existing machine

Use ./sync.sh after changing dotfiles-managed scripts or adding dependencies.

That includes newly added CLI dependencies such as worktrunk: keep them in the repo-managed install sources (Brewfile or scripts/manifest.tsv) so setup.sh and sync.sh bootstrap them automatically.

Pi is part of that reproducible setup:

the Pi CLI is installed from scripts/manifest.tsv
repo-local Pi extensions live under home/.pi/agent/extensions/
public Pi packages/extensions are declared in home/.pi/agent/settings.json and ./sync.sh installs any missing entries via pi install
the repo-local Pi extensions include an edit tool override so edit diffs keep the customized full-width, syntax-highlighted TUI rendering without patching Pi’s installed files

./sync.sh

./sync.sh applies changes by default; use --check for verification only.

If Homebrew/Linuxbrew is missing or not executable on the current host, ./sync.sh now skips Brewfile-managed install/check steps and continues with the rest of the repo-managed sync work on a best-effort basis.

Useful variants:

./sync.sh --check      # verify Brewfile, extra tools, Pi packages, and stow state
./sync.sh --check --verbose
./sync.sh --with-sudo  # also update login shell with sudo-backed chsh

Setup script variants depending on machine state:

./setup.sh                    # new machine bootstrap
./setup.sh --post-brew       # brew already installed
./setup.sh --post-brew --no-sudo

Mise tasks

The repo now uses a hybrid approach:

Homebrew still installs system packages from Brewfile
stow still manages the dotfiles under home/
mise runs the repo tasks declared in mise.toml
scripts/manifest.tsv tracks the non-brew extras managed by the sync flow

Common task entrypoints:

mise run bootstrap   # new machine after setup.sh bootstraps mise itself
mise run sync        # sync an existing machine
mise run sync-sudo   # sync and update login shell with sudo
mise run sync-adopt  # sync and let stow adopt existing unmanaged files
mise run sync-adopt-sudo
mise run check       # verify current machine state

Usage

The most important keybinds are <space><space> in Neovim for the command palette, wherein you can fuzzy find your way through most available commands, and <C-a>? for a list of tmux binds - this is much less nice to use as I have not found a way to add descriptions, but the commands are pretty self explanatory.

Tmux clipboard over SSH

The tmux config is set up to use OSC 52 clipboard sync so tmux -> ssh -> tmux copy operations update the local machine clipboard through the outer tmux client.

Requirements:

tmux 3.6 or newer on both the local and remote machine
a terminal that supports OSC 52 clipboard writes and clipboard reads; this is what tmux uses for set-clipboard, refresh-client -l, and nested passthrough
reload tmux or reattach clients after updating the config so the terminal feature detection is refreshed

Useful tmux clipboard actions:

copy from copy-mode updates the local clipboard through OSC 52
<C-a> y requests the current terminal clipboard and stores it in a new tmux paste buffer

Windows specific tips

To prevent the Hyper key in windows opening copilot, run the following reg-edit command:

REG ADD HKCU\Software\Classes\ms-officeapp\Shell\Open\Command /t REG_SZ /d rundll32