Overview

An AI-native macOS dev environment, wired together and documented with 35 Stow-managed configs, reproducible from one command. Herdr is the primary terminal workspace manager for coding agents. Start with the installation guide, or jump to a section below.

What’s inside

Core Tools Herdr, Ghostty, Neovim (AstroNvim v6), Atuin, and SKHD form the daily-driver agent workspace.

AI Tools Codex CLI, Claude Code, CodeCompanion, and Supermaven - how they are configured and how they fit together.

Workflows End-to-end patterns for coding, database work, and review & debug across the whole toolchain.

Troubleshooting Fixes for window management, terminal, Neovim, AI tools, and performance.

Quick help

Reload services and plugins after editing configs:

# Window manager + hotkeys
brew services restart yabai
brew services restart skhd

# Shell + workspace manager
source ~/.zshrc
herdr server reload-config

New here? Follow the installation guide end to end, then keep the quick reference handy.