dotfiles

Personal development environment configuration managed with GNU Stow.

Platforms: Arch Linux · macOS

Packages

Package	Target	Description
nvim	~/.config/nvim/	Neovim via AstroNvim v5+
zsh	~/.zshrc, ~/.config/zsh/	Zsh with modular config in conf.d/
tmux	~/.tmux.conf	Tmux with tpm plugins
starship	~/.config/starship.toml	Starship shell prompt
ghostty	~/.config/ghostty/	Ghostty terminal emulator
opencode	~/.config/opencode/	Global OpenCode AI config, set up with the OpenAgents Control framework (agents, commands, skills, tools)

Installation

Clone and stow any package:

git clone https://github.com/<user>/dotfiles ~/dotfiles
cd ~/dotfiles

stow nvim/       # deploy a single package
stow nvim zsh tmux starship ghostty opencode  # deploy multiple

Preview symlinks before applying with a dry run:

stow -n nvim/

Structure

Packages follow either XDG (pkg/.config/pkg/) or home (pkg/.toolrc) layout depending on the tool. Stow handles creating the correct symlinks from ~/dotfiles into ~ or ~/.config/.

The .opencode/ directory contains project-specific AI agent context for this repo and is not stowed.