add per-OS file variants via files.<os>/ directories

2026-03-11 10:04:37 +00:00
parent 0215a53fcf
commit 5e9c4b2172
5 changed files with 376 additions and 74 deletions
@@ -23,10 +23,28 @@ go run . <command>
 ~/.dotfiles/
  <package>/
    config.lua
-    files/
-      ...
+    files/              # common files (all OSes)
+    files.linux/        # Linux-specific overrides
+    files.macos/        # macOS-specific overrides
+    files.windows/      # Windows-specific overrides
 ```

+### Per-OS file variants
+
+Create `files.<os>/` directories alongside `files/` for OS-specific overlays:
+
+```
+pi-agent/
+  files/
+    settings.json       # shared config
+  files.linux/
+    agent.json          # Linux-specific
+  files.macos/
+    agent.json          # macOS-specific
+```
+
+On Linux, `agent.json` links to `files.linux/agent.json`. On macOS, it links to `files.macos/agent.json`. Files in `files/` are applied first, then OS-specific variants overlay on top.
+
 ## `config.lua`

 ```lua