My personal macOS configuration files, deployed with GNU Stow.
Each top-level directory is a Stow package that mirrors the layout of $HOME,
so packages can be installed individually.
| Package | Tool | Notes |
|---|---|---|
fish/ |
fish | Two-line prompt, frozen theme, completions |
ghostty/ |
Ghostty | macOS Terminal - JetBrainsMono Nerd Font, Catppuccin Latte / Macchiato (auto-switch) |
monstar/ |
Monstar | Linux Terminal - JetBrainsMono Nerd Font, Catppuccin Latte / Macchiato (auto-switch) |
nvim/ |
Neovim 0.12+ | vim.pack for plugins, vim.lsp for language servers |
starship |
Starship | Custom Shell Prompt |
dotfiles/
├── fish/.config/fish/
├── ghostty/.config/ghostty/
├── monstar/.config/monstar/
└── nvim/.config/nvim/Core:
macOS:
brew install fastfetch fish fzf git neovim starship stow
brew install --cask font-jetbrains-mono-nerd-font ghosttyArch/CachyOS:
sudo pacman -S fastfetch fish fzf git neovim starship stow ttf-jetbrains-mono-nerdparu -S monstar-binLanguage servers enabled in nvim/.config/nvim/init.lua (install only the ones you need):
| Server | Language | Install |
|---|---|---|
ansible |
Ansible | brew install ansible-language-server |
astro |
Astro | npm i -g @astrojs/language-server |
bashls |
Bash | brew install bash-language-server |
docker_language_server |
Docker | brew install docker-language-server |
fish_lsp |
fish | brew install fish-lsp |
gopls |
Go | brew install gopls |
jinja_lsp |
jinja2 | cargo install jinja-lsp |
lua_ls |
Lua | brew install lua-language-server |
ruff |
Python (lint) | uv tool install ruff |
tailwindcss |
Tailwind | brew install tailwindcss-language-server |
tinymist |
Typst | brew install tinymist |
ty |
Python (types) | uv tool install ty |
Optional: mole (macOS cleanup/maintenance CLI) — the fish completions in
fish/.config/fish/completions/ are for its mole / mo commands and are
harmless if it isn't installed.
Neovim plugins (fzf-lua, mini.completion, quicker.nvim, gitsigns.nvim,
nvim-lspconfig) are installed automatically by vim.pack on first start and
pinned in nvim/.config/nvim/nvim-pack-lock.json.
git clone https://codeberg.org/Lxrs/dotfiles.git ~/dotfiles
cd ~/dotfiles
stow -vt "$HOME" fish ghostty monstar nvimInstall a single package by naming just that one, e.g. stow -vt "$HOME" --no-folding nvim.
Dry-run any command first with -n:
stow -nvt "$HOME" fishOther useful invocations:
# re-link after adding, moving or removing files
stow -Rvt "$HOME" fish ghostty nvim
# remove a package's symlinks
stow -Dvt "$HOME" ghosttymkdir -p ~/dotfiles/<tool>/.config
mv ~/.config/<tool> ~/dotfiles/<tool>/.config/<tool>
cd ~/dotfiles && stow -t "$HOME" <tool>
git add <tool> && git commit— config.fish runs fastfetch on every interactive session.
— fish_variables is tracked and contains fish's universal variables, including fish_user_paths with machine-specific absolute paths: (Homebrew bin/sbin, a pinned Node version, ~/.local/bin).
— On a new machine, check echo $fish_user_paths after stowing and adjust the file if any of those paths don't apply.
— conf.d/fish_frozen_theme.fish is also generated by fish (fish_config) - edit it through the web config, not by hand.
— Completions in completions/mo.fish source mole.fish via (status dirname) rather than a hardcoded path, so they work regardless of where the repo is checked out.
— On macOS, Ghostty reads both ~/.config/ghostty/ and ~/Library/Application Support/com.mitchellh.ghostty/, with the latter taking precedence. If a config still exists there, remove it so the stowed one applies.
— Requires 0.12 or newer for vim.pack and the lsp/ directory convention.
— Update plugins with :lua vim.pack.update() and commit the resulting lockfile changes. Leader key is <Space>; <A-h/j/k/l> move between windows in normal, insert and terminal mode.
MIT — take whatever is useful.