dingger.git/README.md, 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:b0cfd10b80443d3f67d263ff4db177bb53cc90edmenu, panel, search: a peach ! in a column of its own; low dimmed more2026-10-27T13:27:14+00:00Igor Soarezigor@soarez.org2026-10-27T13:27:14+00:00urn:sha1:9eddef09c769b315f4eabef6eaf4bb58e70d0966
the ! was the color of the name, read as part of it, and pushed high
names two characters out of line. it is now peach (herdr's palette, no
status uses it) in a fixed-width column every row has, so names line up.
a low agent's name is dimmed to 0.5 (0.7 was hard to see).
pi: 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.
docs: mark as unread does not work from inside claude code2026-10-27T12:20:08+00:00Igor Soarezigor@soarez.org2026-10-27T12:20:08+00:00urn:sha1:7455ddfcf6158ec1304d1188a9530f7973e845d5mark 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).
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.