# Pi Status Bridge Noctalia plugin

This Noctalia v4 plugin is an aggregate-status **launcher**. It renders the
workspace counts supplied through its `plugin:pi-status-bridge` IPC handler.
Clicking its bar widget starts `pi-status-bridge.service` and toggles the
standalone Pi Status UI. Set `PI_STATUS_UI_BINARY` to override the UI binary;
the packaged local build path is the fallback.

Use `pi-status-bridge-client` to query the owner-only Unix bridge socket. A
local integration script should translate responses and events into the plugin
IPC handler's `setBridgeState(state, projectLabel, attentionCount, detail)`
call. The plugin never opens a Noctalia panel, sends prompts, switches
sessions, chooses a worktree silently, or approves extension requests.

Install/register it through Noctalia's normal plugin workflow, then add its
bar widget in Noctalia settings.