From 189a0e03ae213d93d67d74635642169254bcdaa1 Mon Sep 17 00:00:00 2001 From: ocpway Date: Thu, 30 Jul 2026 04:32:51 +0300 Subject: [PATCH] Add AGENTS.md: keep config snippets in sync with live waybar config Notes the two-way relationship: scripts are symlinked (one source of truth), but the config/ snippets are inserted by hand into existing omarchy files and must be edited in both places to stay in sync. --- AGENTS.md | 37 +++++++++++++++++++++++++++++++++++++ 1 file changed, 37 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 0000000..19d078e --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,37 @@ +# Agents + +## Edit this repo and the live config together + +Two kinds of files live here. They link to the system differently. + +### 1. Scripts — symlinked (one source of truth) + +`scripts/ocd-waybar` and `scripts/ocd-waybar-ctl` are symlinked into +`~/.config/waybar/scripts/`: + +``` +~/.config/waybar/scripts/ocd-waybar -> /work/ocpway/scripts/ocd-waybar +~/.config/waybar/scripts/ocd-waybar-ctl -> /work/ocpway/scripts/ocd-waybar-ctl +``` + +Edit the file in this repo. The live copy updates at once. Do not edit through +the symlink path and do not keep a separate copy. + +### 2. Config snippets — inserted by hand (two copies, keep in sync) + +The three files under `config/` are not separate files on the system. They are +snippets inserted into existing omarchy config files: + +| Snippet in this repo | Inserted into (live file) | +|---|---| +| `config/waybar-config.jsonc` | `~/.config/waybar/config.jsonc` (the `custom/ocd` module block, plus the `custom/ocd` entry in `modules-right`) | +| `config/waybar-style.css` | `~/.config/waybar/style.css` (the `#custom-ocd` block) | +| `config/hypr-autostart.conf` | `~/.config/hypr/autostart.conf` (the `exec-once` line) | + +These two copies are independent and can drift. When you change a snippet +here, also change the matching place in the live file. When you change the +live file, also update the snippet here. Keep them byte-for-byte equal. + +If the daemon ever stops matching these instructions, re-derive: diff each +`config/*` snippet against the matching region of its live file, and reconcile +both directions. \ No newline at end of file