diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 21 |
1 files changed, 20 insertions, 1 deletions
@@ -94,6 +94,18 @@ than a poll is still a completion. skipping the window you already look at. - **Notifications**: "needs attention" (blocked) and "finished" (done), with herdr's sounds; silent for completions you are already watching. +- **Importance**: mark an agent high, normal (the default), or low. Within a + status, more important agents are listed first, so a jump goes to them + first; status still comes first (a blocked low agent before a done high + one). A high agent shows a bold `!` before its name; a low agent's name is + lightly dimmed, its second line says "low", and it makes no sound (it + still notifies, and waits in line like any other). In pi, type + `/importance high|normal|low` (no argument: the current level); pi saves + it with the session, so it comes back after `/reload`, a restart, or a + restore, and its footer shows a level other than normal. For other agents, + run `dingger importance high|normal|low` in the agent's pane (in Claude + Code: `! dingger importance high`), or pass `--pane`; it lasts until the + agent exits. ## Where state comes from @@ -108,7 +120,13 @@ than a poll is still a completion. manifests, for agents without hooks. All per-pane state lives in tmux pane options (`@agent_state`, -`@dingger_since`, `@dingger_hook`), so restarting dingger loses nothing. +`@dingger_since`, `@dingger_hook`, `@dingger_importance`), so restarting +dingger loses nothing. + +The pi extension's reports carry the agent's importance. Other pi +extensions can follow it on pi's event bus: `dingger:importance` with +`{ level }`, at session start and on every change; it is saved in the +session as a custom entry of type `dingger-importance`. ## Usage @@ -116,6 +134,7 @@ All per-pane state lives in tmux pane options (`@agent_state`, dingger watch # the daemon (run by launchd, see below) dingger status # agents in priority order dingger focus [--pane ID] # jump to an agent (default: the top waiter) +dingger importance [LEVEL] # an agent's importance: high, normal, low dingger install pi # install the pi state-reporting extension dingger install claude # report Claude Code sessions, for restore dingger install zsh # record typed command lines, for restore |