aboutsummaryrefslogtreecommitdiffstats
path: root/desktop/modules/status/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'desktop/modules/status/README.md')
-rw-r--r--desktop/modules/status/README.md13
1 files changed, 10 insertions, 3 deletions
diff --git a/desktop/modules/status/README.md b/desktop/modules/status/README.md
index ea069d6..064044e 100644
--- a/desktop/modules/status/README.md
+++ b/desktop/modules/status/README.md
@@ -1,7 +1,7 @@
# status
-Desktop modes as state: `dnd`, `presentation`, `nolock` and `quiet`, owned by
-the `Status` singleton and stored as files under `$XDG_RUNTIME_DIR`. A fifth,
+Desktop modes as state: `dnd`, `presentation`, `nolock`, `quiet` and `nolamp`, owned by
+the `Status` singleton and stored as files under `$XDG_RUNTIME_DIR`. A sixth,
`status.gaming`, is written only by the shell's game detector; it is not a
mode `statusctl` exposes.
@@ -11,6 +11,7 @@ mode `statusctl` exposes.
$XDG_RUNTIME_DIR/status.presentation
$XDG_RUNTIME_DIR/status.nolock
$XDG_RUNTIME_DIR/status.quiet
+ $XDG_RUNTIME_DIR/status.nolamp
$XDG_RUNTIME_DIR/status.gaming
Each holds `0` or `1`; a missing file means off. That directory is tmpfs, so a
@@ -63,7 +64,7 @@ asks `statusctl quiet get` and plays nothing on a 1. `~/bin/notify-sound` is a
symlink to the repo copy, like `statusctl`.
notify-sound claude Claude Code's Notification hook
- notify-sound <event> opencode-notifier's command hook
+ notify-sound <event> <session> opencode-notifier's command hook
The opencode notifier runs its command for every event, `session_started` and
`user_message` included, so an argument with no sound plays nothing; only
@@ -71,6 +72,12 @@ The opencode notifier runs its command for every event, `session_started` and
are off in `opencode-notifier.json`, and it rereads that file on every event,
so neither change needs an opencode restart.
+`nolamp` keeps the agent lamp (the sibling agent-lamp repo) dark. The shell
+does nothing with it: agent-lamp's renderer reads the file each second and
+restores the bulb while it is 1, keeping the agents' states for when it
+turns off. `notify-sound` forwards the opencode notifier's two arguments
+(`<event> <session>`) to `agent-lamp`, before the quiet check.
+
## Game detection
Presentation is set automatically while a game runs, so a fullscreen game does