dingger.git/crates, branch masterWatches the AI coding agents in your tmux panes on macOS and tells you which need you, from the menu bar, a floating panel, the status line and notifications; jumps to them, and restores tmux sessions and agents after a crash
https://git.soarez.net/sz/dingger.git/atom?h=master2026-11-03T11:12:21+00:00count pi costs as pi's footer does: compaction and other priced calls, not event logs2026-11-03T11:12:21+00:00Igor Soarezigor@soarez.org2026-11-03T11:12:21+00:00urn:sha1:9518a5442576268a04e7dbfcddeb2457add2f189show each pi agent's context use: a meter in the panel and search, text in the menu2026-11-03T11:05:57+00:00Igor Soarezigor@soarez.org2026-11-03T11:05:57+00:00urn:sha1:bd1eb9ef9b3b89ff5825eb8bf9b2e978167c9ad0show what pi agents cost today, this week and this month, counting forked replies once2026-11-01T08:22:01+00:00Igor Soarezigor@soarez.org2026-11-01T08:22:01+00:00urn:sha1:8146d1db419e8bdacd75920da6f3761abf724853mark forgotten drafts in pi agents' input boxes, and keep them across a crash or restore2026-10-30T16:59:43+00:00Igor Soarezigor@soarez.org2026-10-30T16:59:43+00:00urn:sha1:959f0d46cac1a09d0821da599d8dff54d1147892reload pi agents on an old extension: versioned extension, control socket, menu item and reload-agents2026-10-30T15:27:21+00:00Igor Soarezigor@soarez.org2026-10-30T15:27:21+00:00urn:sha1:b0cfd10b80443d3f67d263ff4db177bb53cc90edpi: no footer line for the importance2026-10-27T12:25:44+00:00Igor Soarezigor@soarez.org2026-10-27T12:25:44+00:00urn:sha1:a7e065cd4f39abda178af58127ead1ab502e0f3b
it took a line of its own in pi's footer. pi says the level when it is
set, and /importance alone shows it; pi clears the old line at /reload.
mark as unread: make an idle agent done again, to come back to it2026-10-27T12:12:28+00:00Igor Soarezigor@soarez.org2026-10-27T12:12:28+00:00urn:sha1:50c433e82c368b9861a89deecb74e5f29fa50353
like "mark as unread" in mail: an agent you have seen (idle) becomes done
again, last among done agents of its importance, with no sound or
notification. it stays done until you come back to it: leave its tmux
window and return, or jump to it. marked while you look at it, it holds
until you look away (`held`); a new turn clears it. only idle agents can
be marked.
- daemon: `pane.mark_unread` on the hook socket; the watcher applies it
after the tick's observations (mark_unread, advance's hold rule).
- `dingger unread [--pane]`: refuses done, working, blocked, and panes
without an agent; returns once the agent shows as done.
- pi: /unread (refused while the agent works or is blocked).
- panel: right-click an idle agent in the full list, "Mark as unread".
- search: ⌘U or right-click marks the selected idle agent; the footer
offers ⌘U when it applies; search stays open.
tests: unit (hold, jump, new turn, idle only), e2e step 22 (queue
position, hold, look away and back, jump, refusals, no sound, menu, the
extension), pi-live in real pi 1.4 (a mark, not a turn: an unknown
command would also end done), swift selftest (menu only for idle, footer).
hooks: answer each message, so the extension sends a report once2026-10-26T14:40:50+00:00Igor Soarezigor@soarez.org2026-10-26T14:40:50+00:00urn:sha1:53e86be78d7a80a114cf265dbf8189606297d040
the pi extension (herdr's protocol) waits for a reply line and sends a
report again after 0.5 s without one; dingger never replied. every report
arrived twice and took about 2 s, delaying the next one (the live log: 196
of 400 reports repeated the previous one, 0.49 s later). the daemon now
answers each line with {"ok":true}; senders that do not read replies
(dingger poke, importance, the claude hook) are unaffected.
e2e step 21: one report, done in 0.38 s; without replies, two, 2.08 s.
importance: mark an agent high, normal, or low2026-10-26T14:32:18+00:00Igor Soarezigor@soarez.org2026-10-26T14:32:18+00:00urn:sha1:185af91b4d525db6c192a050b53615772fb5fe11
within a status, more important agents are listed first, and so jumped to
first; status stays first. a high agent shows a bold ! before its name, a
low agent's name is lightly dimmed with "low" on its second line, and it
makes no sound (it still notifies and waits in line).
in pi, /importance high|normal|low (completes the levels; none once one is
typed out, so Enter runs it). the extension saves it in the session as a
custom entry (dingger-importance), so /reload, restarts, /resume and
restore bring it back; /new starts at normal. it shows a level other than
normal in pi's footer, emits dingger:importance { level } for other
extensions, and sends it with every report. for other agents, `dingger
importance [level] [--pane]`; it refuses a pi that reports itself, whose
saved level would win.
the daemon stays the one writer of pane state: it writes
@dingger_importance (unset for normal), which goes with the agent and
survives a daemon restart. `dingger status` marks high and low.
tests: e2e step 21 (order, the option, no sound for low, the menu bar,
the command, the extension through a harness that now matches pi's
extension API), a DINGGER_SOUND seam so sounds are observable, and a
status-line check that read the counts once (flaky) now polls.
pi-live: /importance in real pi 1.4, its footer and session entry, and the
level after a restore; every pi there now uses the test's agent directory
(a restored pi read the user's). negative controls fail each part.
terminal commands are silent when tmux runs them2026-10-25T05:44:25+00:00Igor Soarezigor@soarez.org2026-10-25T05:44:25+00:00urn:sha1:5d7ed0172366eef885fd490136e8b826a9722339
tmux shows a hook's output and a non-zero exit in view mode over the pane.
the focus hook's normal outcomes (focus moved on, Ghostty not in front)
exited 1, and the one-second settling made "focus moved on" common:
"'dingger terminal focused --client ...' returned 1" kept covering panes.
`dingger terminal focused` and `terminal raise` now always exit 0 and
print nothing unless run by hand.
tmux::client_format checks that tmux answered for the client asked about:
for a client that is gone, tmux answers for the current one, so a raise
for a client that had just detached raised another client's terminal.
e2e step 20: no pane in view mode after the hook's failures, a gone
client raises nothing, and a focus held past the settling second; the old
code fails the new checks.