Done and notifications

Moontors tells you when a session has finished or needs you, on its card, in the header and with a notification, so you can get on with something else while the agents work.

Sessions, the board and their cards are in Sessions and the board.

Done, not seen yet

When a session you sent to work finishes and you haven’t looked at it, its card says Done in blue, and a glowing blue pill in the header, such as 2 done, counts how many there are. Click it to go to the next one.

• A session counts as sent to work once you send it a message or a command, from your computer or your phone, including a message that had to wait for its turn. A session only another session’s agent sent a message to doesn’t count, and neither does a turn the agent starts by itself.
• It counts as finished when its status says Done, so a team’s session waits for its subagents, and a session with a timer waits past its wake-up.
• You’ve seen it once it’s open in the panel of the Moontors window you’re in, or open on your phone with Moontors in front. Seeing it on one clears it on both. One that finishes while you’re looking at it never turns blue.
• Stopping it yourself, an error or a crash leaves nothing to see, and archiving it clears it.
• If another session’s message sets it running before you’ve looked, the blue goes while it runs and comes back when it’s done, as you still haven’t seen what it finished for you. Your own new message clears it.

Notifications

Moontors notifies you when a session starts waiting for you, hits an error, or stops because the agent crashed, and when it’s done (below), unless you’re looking at that session: one that comes while it’s open in the panel of the Moontors window you’re in is dropped, never shown later. Each is titled with the session’s title and says “Waiting for you”, the error (“Stopped on an error” where there’s none to name), or “The agent crashed”; a newer one for the same session replaces the last. Clicking a notification opens the session, its transcript in the panel. A view open over the board, such as Git or Files, or a page such as Settings, closes first, keeping what it had for the next time you open it.

Moontors tells you when a session is done: the bell among its buttons in the panel’s header, Tell me when it’s done, is on for every new session, a fork too. Once its status says Done, Moontors notifies you, “Finished, with nothing left running”. Click the bell to turn it off, and again to turn it back on; it stays as you leave it for that session, also after a restart, and shows on the session’s card while it’s on, where a click turns it off too.

To hear once several sessions are all done, right-click a bell, or press the menu key or Shift+F10 on it: every session on the board shows under its section, with a filter, each saying whether it’s told of alone or with a group, and this session’s group checked. Check the ones to join and choose Apply. The session and those checked become one group, each with the group’s bell, two bells ringing, and Moontors notifies you once, with their titles, as the last of them is done, even while you’re looking at that one, as it tells you of the others; clicking that notification opens the one that finished last. A session you uncheck leaves the group, its bell off. Clicking a group’s bell takes that session out the same way, and so does archiving it; a group left with one session is that session’s own bell again.

To name a group, type the name in the field beside Apply before you apply. The notification then says the group’s name and how many sessions finished, rather than their titles, and the group’s bells and lines in the list say its name too. Opening the list from a session in a named group fills the field with the name, so Apply keeps it, or changes it as you edit it; clear the field to leave the group without one. A group that loses its sessions loses its name.

On macOS, Moontors keeps running when you close its window, so notifications still arrive. On Windows and Linux, closing the window quits Moontors, and notifications stop until you open it again. The sessions keep working either way.

A plugin’s notifications

An agent’s plugin can notify you itself, as a Claude Code mod does with $.ui.notify. Moontors shows each as a notification titled with its session’s title and the plugin it’s from, by the plugin’s name, then what the plugin said. Where another plugin changed it on its way, the title says so. It shows even while you’re looking at that session, as nothing else shows what it says, and clicking it opens the session.

• A plugin can ask for one later, up to a week ahead. Moontors holds it, through a restart too, and shows it then; one due while Moontors wasn’t running at all shows when it next starts.
• A plugin can ask for one to be dropped if you come back first. It goes once you send that session a message or a command, or answer its question or permission, on your computer or your phone.
• A newer one from the same plugin under the same name replaces the last, shown or waiting, and the plugin can take one back. Once a plugin leaves the session, nothing of it waits, and archiving or deleting the session drops all it has waiting.
• One plugin’s notifications in a session show 3 at once, then 3 a minute. Past that, only the newest waits for its turn, a later one taking its place.
• Your phone gets plugins’ notifications 5 at once, then 10 a minute, every plugin’s together, so Moontors’ own always reach it; the rest still show on your computer.
• A notification shows its words as written, a tag or a link among them, never as formatting.

With a Moontors account whose plan includes your phone’s notifications (see Your Moontors account), the same notifications reach each phone paired with this computer that doesn’t have the app open right then, connected or not, a group’s as one and a plugin’s too, and tapping one opens its session. Your computer sends them, so they go out while the sessions keep working, with the window closed too. Each is worded on your computer and sealed for that phone alone: Moontors’ server, and Google and Apple, which carry it, can’t read it, and until your phone opens it an iPhone shows “Moontors needs you”. On the phone, they come once you allow them there (see the phone’s notifications).