Skip to content
LxxrsPublic

Repository files navigation

dotfiles

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.

What's in here

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/

Requirements

Core:

macOS:

brew install fastfetch fish fzf git neovim starship stow
brew install --cask font-jetbrains-mono-nerd-font ghostty

Arch/CachyOS:

sudo pacman -S fastfetch fish fzf git neovim starship stow ttf-jetbrains-mono-nerd
paru -S monstar-bin

Language 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.

Installation

git clone https://codeberg.org/Lxrs/dotfiles.git ~/dotfiles
cd ~/dotfiles
stow -vt "$HOME" fish ghostty monstar nvim

Install 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" fish

Other useful invocations:

# re-link after adding, moving or removing files
stow -Rvt "$HOME" fish ghostty nvim

# remove a package's symlinks
stow -Dvt "$HOME" ghostty

Adding a new config

mkdir -p ~/dotfiles/<tool>/.config
mv ~/.config/<tool> ~/dotfiles/<tool>/.config/<tool>
cd ~/dotfiles && stow -t "$HOME" <tool>
git add <tool> && git commit

Notes

fish

— 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.

Ghostty

— 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.

Neovim

— 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.

License

MIT — take whatever is useful.

Used by

Contributors

Languages