Initial import: chezmoi source for CachyOS + Umbriel + Noctalia

Imported from prdlk/dotfiles master (efdd827). Drops the niri, Hyprland/Omarchy,
macOS, and Blume docs-site layers; docs/ is plain Markdown.

docs/README.md

@@ -0,0 +1,75 @@
+# dots
+
+prdlk's CachyOS dotfiles, managed with chezmoi. One command installs chezmoi and applies the whole setup.
+
+```sh
+sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply https://prad.codes/env/cachyos.git
+```
+
+That command installs chezmoi, clones [env/cachyos](https://prad.codes/env/cachyos) together with its submodules, asks three questions (name, email, machine role), installs packages, and applies every config. See [Installation](installation.md) for the prerequisites, the age key, and the options.
+
+This is the CachyOS variant: CachyOS (Arch) with the Umbriel compositor and the Noctalia shell.
+
+## Contents
+
+- [Installation](installation.md)
+- [How it works](chezmoi/README.md)
+  - [Config and roles](chezmoi/config.md)
+  - [Packages and aliases](chezmoi/data.md)
+  - [Apply scripts](chezmoi/scripts.md)
+  - [Externals and ignore rules](chezmoi/externals-and-ignore.md)
+- [Shell](shell/README.md)
+  - [fish](shell/fish.md)
+  - [bash and zsh](shell/bash-zsh.md)
+  - [Aliases](shell/aliases.md)
+  - [Scripts](shell/scripts.md)
+  - [Starship](shell/starship.md)
+  - [atuin](shell/atuin.md)
+- [Terminal](terminal/README.md)
+  - [kitty](terminal/kitty.md)
+  - [Ghostty](terminal/ghostty.md)
+  - [tmux](terminal/tmux.md)
+  - [herdr](terminal/herdr.md)
+- [Tools](tools/README.md)
+  - [Git](tools/git.md)
+  - [GitHub CLI](tools/github-cli.md)
+  - [Neovim](tools/neovim.md)
+  - [Yazi](tools/yazi.md)
+  - [Lazygit](tools/lazygit.md)
+  - [Lazydocker](tools/lazydocker.md)
+  - [bat](tools/bat.md)
+  - [television](tools/television.md)
+  - [Topgrade](tools/topgrade.md)
+  - [Hunk](tools/hunk.md)
+  - [drydock](tools/drydock.md)
+  - [LeetCode](tools/leetcode.md)
+- [Desktop](desktop/README.md)
+  - [Umbriel](desktop/umbriel.md)
+  - [Fonts and default apps](desktop/fonts-and-apps.md)
+- [AI agents](ai/README.md)
+  - [Skills](ai/skills.md)
+
+## What's managed
+
+- [How it works](chezmoi/README.md): chezmoi layout, machine roles, symlink mode, age encryption, package manifests, apply scripts, and externals.
+- [Shell](shell/README.md): fish, bash, and zsh with shared aliases, starship, atuin, and the `~/.local/bin` scripts.
+- [Terminal](terminal/README.md): kitty, ghostty, tmux, and herdr.
+- [Tools](tools/README.md): git, gh and gh-dash, neovim, yazi, lazygit, lazydocker, bat, topgrade, hunk, and more.
+- [Desktop](desktop/README.md): Umbriel with Noctalia on CachyOS, fonts, default apps, and the eGPU notes.
+- [AI agents](ai/README.md): Claude Code, omp, and the shared agent skill library.
+
+## Machine roles
+
+The first apply asks for a role. It controls which parts of the repo land on the machine.
+
+| Role | Platform | Gets |
+| --- | --- | --- |
+| `desktop` | CachyOS / Arch Linux | Everything: universal toolset plus the Linux desktop layer (Umbriel, Noctalia) |
+| `laptop` | CachyOS / Arch Linux | Same as `desktop` |
+| `server` | Any | Universal toolset only |
+
+The default is `desktop`. See [Configuration](chezmoi/config.md) and [Ignore rules](chezmoi/externals-and-ignore.md).
+
+## Theme
+
+The terminal and agent palette is **CherryBlossom**, the custom Noctalia palette in [prdlk/noctalia](https://github.com/prdlk/noctalia) (`palettes/CherryBlossom.json`). Ghostty selects its `cherry-blossom` theme, tmux colors its tab bar, popups, and command palette with it, atuin selects `cherry-blossom`, television selects `cherry-blossom-transparent` (no background, so the terminal's shows through), lazygit and lazydocker use its border and selection colors, and omp selects its `cherry-blossom` dark theme. nvim, bat, and yazi still select **cyberdream**; fish ships a cyberdream theme but does not select it. kitty's colors come from the shared kitty external. The koda and ii-auto variants are also shipped for ghostty, kitty, and yazi. The font is **Victor Mono Nerd Font**.