summaryrefslogtreecommitdiff
path: root/AGENTS.md
diff options
context:
space:
mode:
Diffstat (limited to 'AGENTS.md')
-rw-r--r--AGENTS.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/AGENTS.md b/AGENTS.md
index 097985c..22da5dc 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -390,12 +390,26 @@ shadowing cannot work, because the remap has already run by the time
reports whether the watchers and the tap are still up; that needs `hs.ipc`,
which `init.lua` requires for exactly this kind of check.
+Wispr Flow dictates from that key, set by `bin/wispr-keys`: Push to talk on F20,
+Command Mode on Ctrl+F20, written into Flow's own `config.json` because its
+settings screen refuses F20 without a modifier while its key listener accepts
+it. Run it by hand on a Mac that has just installed Flow, and again after
+re-binding either action in Flow's settings, which overwrites what it sets. It
+keeps the file it first found as `config.json.pre-wispr-keys`.
+
+**It is not a `link/` part, and should not become one.** It has to quit and
+restart Flow to make an edit stick, and `link.sh` runs unattended after every
+sync — a part that can kill a dictation in progress is the wrong trade for a
+binding that can wait until someone asks. That is also why it exits non-zero
+when Flow will not restart: nothing else's run depends on it.
+
### Utility Scripts
The `bin/` directory contains various utility scripts for:
- Theme management (`theme`)
- Notification sending (`notify`)
- Development tools (`vi` wrapper, `smack`, `pyexec`)
- System utilities (`wifi`, `default-browser`, `truecolour-test`, `open` — macOS-style `open` for Linux desktops; hands over to `/usr/bin/open` on macOS)
+- App settings that no `defaults` key reaches (`wispr-keys` — Flow's dictation shortcuts; see the Keyboard section for why it lives here and not in `link/`)
## Development Notes