Rig

Rig is a personal macOS development setup. It keeps editor, terminal, shell, window manager, Git, Codex, Homebrew, and macOS defaults in one repository. Each module is installed into $HOME with GNU Stow, so the live config stays symlinked to the repo. Use it to set up a new machine, keep a workstation consistent, or inspect the exact config behind the anonymous.dev development environment.

Managed Modules

Module	What it configures
AeroSpace	Tiling window manager with a 9x9 workspace grid
Neovim	Neovim config built around `mini.nvim`, LSP, Git, DAP, requests, and AI tools
Kitty	Terminal emulator config with tab navigation, bell notifications, and a warm dark theme
Zsh	Shell with autocomplete, syntax highlighting, and lazy runtimes
Git	Editor and global ignores
Codex	Codex CLI defaults, trusted projects, notifications, MCP servers, and memories
Brew	Homebrew taps, formulas, and casks
macOS	System defaults for Dock, Finder, keyboard, and appearance

Quick Start

git clone https://github.com/anonymous-dev-org/rig.git
cd rig

./init.sh

The installer asks before each step. Use --yes to install every available module without prompts:

./init.sh --yes

Prerequisites

Requirement	Notes
macOS	Target platform
Git	Required to clone and update the repo
Homebrew	Installed by `./brew/install-brew.sh` if missing
GNU Stow	Installed from the Brewfile
Swift compiler	Optional; used to compile AeroSpace picker apps

How It Works

Each module mirrors paths under your home directory.

rig/
  neovim/.config/nvim/init.lua   -->   ~/.config/nvim/init.lua
  zsh/.zshrc                     -->   ~/.zshrc
  kitty/.config/kitty/kitty.conf -->   ~/.config/kitty/kitty.conf
  codex/.codex/config.toml       -->   ~/.codex/config.toml

Run Installation for setup and update commands.

Getting Started

Modules

Reference

Managed Modules

Quick Start

Prerequisites

How It Works

​Managed Modules

​Quick Start

​Prerequisites

​How It Works

Managed Modules

Quick Start

Prerequisites

How It Works