dotfiles

Personal dotfiles. Managed with GNU Stow + mise. Repo layout mirrors ~/ — stow symlinks files into place.

Structure

.
├── .config/             # XDG configs: nvim, helix, fish, git, zellij, ghostty, atuin, direnv, nix, sketchybar, worktrunk
├── .claude/             # Claude Code project-local overrides (settings.local.json)
├── .zshrc, .zshrc_*     # Modular zsh config (aliases, git, go, mise, fish, ...)
├── .tmux.conf
├── .wezterm.lua
├── .aerospace.toml
├── .mise.toml           # mise tasks (incl. unified `stow`)
├── .mcp.json            # global MCP server config
├── .stow-local-ignore   # exclusions for repo-root stow package
│
├── harness/             # Per-harness packages (separate stow targets)
│   ├── claude/          # → ~/.claude   (settings.json, hooks, agents, commands, scripts, skills, CLAUDE.md, RTK.md, agent-settings, plugins/local-plugins)
│   ├── pi/              # → ~/.pi       (agent/settings.json)
│   ├── plugins/         # Shared plugin pool consumed by claude/pi via symlinks (NOT stowed)
│   └── scripts/         # sync-marketplace.sh — regenerates local-plugins symlinks + marketplace.json
│
├── skills/              # Plan-* skill source (consumed by skill-manager at runtime, NOT stowed)
├── ansible/             # Package installation playbook (run in-place)
├── scripts/             # Misc shell scripts (not stowed)
├── hammerspoon/         # macOS automation Lua
├── raycast/             # Raycast extensions
├── alacritty/, vscode/  # legacy app configs
└── _notes/              # Work-manager notes (gitignored runtime)

Stow targets

Source	Target	Contents
repo root	~	shell, .config/*, .tmux.conf, etc. (gated by .stow-local-ignore)
harness/claude	~/.claude	Claude Code user config + plugin marketplace
harness/pi	~/.pi	Pi agent settings (skills owned by skill-manager at runtime)

Install

Prerequisites: nix, mise, stow, ansible.

# 1. Nix-darwin (Mac system packages)
nix run nix-darwin -- switch --flake .config/nix-darwin

# 2. Other packages via ansible
ansible-playbook ansible/install_packages.yaml

# 3. Symlink everything into ~ (repo root + harness/claude + harness/pi)
mise run stow

To remove all symlinks:

mise run unstow

Adding a Claude Code plugin

Plugins live in harness/plugins/<name>/{claude,pi}/. The sync-marketplace.sh step (run automatically by mise run stow) generates the marketplace entries and per-plugin symlinks under harness/claude/plugins/local-plugins/.