readme;agents.md;zellij niri and alacritty

README.md

@@ -0,0 +1,24 @@
+# Dotfiles
+
+This is my personal dotfiles repository, managed by **Sigil**.
+
+## Layout
+```
+~/.dotfiles/
+  <package>/
+    config.lua
+    files/
+      ...
+```
+
+Each package has a `config.lua` that defines the target path per OS.
+
+## Usage (Sigil)
+- `sigil apply` — apply symlinks
+- `sigil apply --prune` — prune stale links
+- `sigil add <path>` — add a file or folder into the repo
+- `sigil status` — show stale links
+- `sigil unlink <spec>` — restore files and remove from repo
+- `sigil remove <spec>` — same as unlink, plus delete package/subpath
+
+See `AGENTS.md` for agent-specific guidance.