docs: add comprehensive documentation for AI agents, chezmoi workflow, shell setup, desktop configuration, terminal multiplexers, and developer tools

docs/terminal/ghostty.mdx

@@ -0,0 +1,67 @@
+---
+title: Ghostty
+description: Ghostty configuration and its herdr key sync.
+---
+
+GPU terminal emulator kept alongside kitty. Its bindings send the same herdr prefix bytes as the kitty herdr host.
+
+| | |
+| --- | --- |
+| Source | `dot_config/ghostty/config`, `dot_config/ghostty/config.ghostty`, `dot_config/ghostty/themes/` |
+| Target | `~/.config/ghostty/` |
+| Install | Not listed in `.chezmoidata/packages.yaml`; install separately |
+
+Ghostty reads both `config` and `config.ghostty`. `config` holds all settings; `config.ghostty` contains a single line, `theme = noctalia`, which selects the active theme.
+
+## Options
+
+| Option | Value |
+| --- | --- |
+| `font-family` / `font-size` | `Victor Mono NF` / `12.5` |
+| `background-opacity` / `background-blur` | `0.9` / `true` |
+| `window-decoration` | `false`; `gtk-titlebar = false` |
+| `window-padding-x/y` | `12` |
+| `cursor-style` | `underline`, blinking |
+| `scrollback-limit` | `3023` |
+| `mouse-hide-while-typing` | `true` |
+| `copy-on-select` | `false` |
+| `confirm-close-surface` | `false` |
+| `app-notifications` | `no-clipboard-copy,no-config-reload` |
+| `quit-after-last-window-closed` | `false`, delay `5m` |
+| `shell-integration` | `detect`, features `cursor,sudo,title,no-cursor` |
+| `gtk-single-instance` | `true` |
+
+## Keybindings
+
+| Key | Action |
+| --- | --- |
+| `cmd+c` / `cmd+v` | Copy / paste |
+| `cmd+n` | New window |
+| `ctrl+plus` / `ctrl+minus` / `ctrl+zero` | Font size +1 / -1 / reset |
+| `shift+enter` | Sends a literal newline |
+| `ctrl+shift+alt+,` | Reload config |
+
+### herdr sync
+
+Placed last so they override defaults. Each sends `ctrl+b` (`\x02`) followed by a key; see [herdr](/terminal/herdr).
+
+| Key | Sends |
+| --- | --- |
+| `ctrl+shift+n` | `prefix %` (split vertical) |
+| `ctrl+shift+t` | `prefix c` |
+| `ctrl+tab` / `ctrl+shift+tab` | `prefix n` / `prefix p` |
+| `ctrl+shift+f` | `prefix s` (workspace picker) |
+| `ctrl+shift+l` / `ctrl+shift+h` | `prefix .` / `prefix ,` (next / previous agent) |
+| `ctrl+shift+j` / `ctrl+shift+k` | `prefix j` / `prefix k` (next / previous workspace) |
+| `super+enter` | `prefix N` |
+| `super+r` | `prefix W` |
+| `ctrl+shift+r` | `prefix T` |
+| `ctrl+shift+,` | `prefix S` (herdr settings) |
+
+## Themes
+
+| Theme | Notes |
+| --- | --- |
+| `noctalia` | Active. Palette matching the Noctalia shell. |
+| `ii-auto` | Auto-generated by the ii wallpaper theming system; not meant to be edited. |
+| `koda-dark` / `koda-light` | Koda palettes with `bold-is-bright = true`. |