> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anonymous.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Rig

> Personal macOS development rig managed with GNU Stow.

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](https://www.gnu.org/software/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](/packages/rig/aerospace) | Tiling window manager with a 9x9 workspace grid                                         |
| [Neovim](/packages/rig/neovim)       | Neovim config built around `mini.nvim`, LSP, Git, DAP, requests, and AI tools           |
| [Kitty](/packages/rig/kitty)         | Terminal emulator config with tab navigation, bell notifications, and a warm dark theme |
| [Zsh](/packages/rig/zsh)             | Shell with autocomplete, syntax highlighting, and lazy runtimes                         |
| [Git](/packages/rig/git)             | Editor and global ignores                                                               |
| [Codex](/packages/rig/codex)         | Codex CLI defaults, trusted projects, notifications, MCP servers, and memories          |
| [Brew](/packages/rig/brew)           | Homebrew taps, formulas, and casks                                                      |
| [macOS](/packages/rig/macos)         | System defaults for Dock, Finder, keyboard, and appearance                              |

## Quick Start

```bash theme={null}
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:

```bash theme={null}
./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](/packages/rig/installation) for setup and update commands.