# Pi Status Bridge Noctalia plugin

This Noctalia v4 plugin is deliberately **presentation-only**. It renders
state supplied through its `plugin:pi-status-bridge` IPC handler and opens its
panel with `pluginApi.togglePanel`.

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 starts Pi, opens TCP, 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.