Chat Status Marklet

An Agent Zero plugin that adds visual status indicators (marklets) to sidebar chat items, so you always know which chats have running processes or unread results.

Features

Indicator	Visual	When Shown	Clears When
Running	🔵 Pulsing blue dot	A process is actively running in that chat	The process stops
Finished (unseen)	🟢 Solid green dot	A process finished but the chat has not been viewed yet	The chat is selected/clicked

How It Works

1. Monitors all chat contexts for running state transitions via the framework polling mechanism
2. When a chat's process transitions from running to stopped, marks it as "finished unseen"
3. If the user is already viewing that chat when it finishes, no unseen mark appears
4. Clicking the chat clears the unseen indicator immediately
5. Unseen state persists across page refreshes via sessionStorage

Installation

Install from the Agent Zero Plugin Hub, or manually:

cd /a0/usr/plugins
git clone https://github.com/mbradaschia/a0-chat-status-marklet.git chat_status_marklet

Then refresh your browser.

Technical Details

The plugin hooks into the existing sidebar chat list using the sidebar-chats-list-end extension point. It creates an Alpine.js store (chatStatusMarklet) that:

1. Patches chatsStore.applyContexts() to intercept every poll update and detect running→stopped transitions
2. Patches chatsStore.selectChat() to clear unseen marks when a chat is selected
3. Uses MutationObserver with requestAnimationFrame debouncing to inject/remove dot elements into each chat row
4. Supports both dark mode and light mode with appropriate color adjustments

Compatibility

Requires Agent Zero v0.8.2 or later (extension points system).

License

MIT License. See LICENSE for details.