zellij-state-monitor is a headless zellij plugin that exposes live session state to external consumers. It subscribes to a small set of zellij events — mode changes, tab updates, pane updates, session updates — and keeps an in-memory snapshot current at all times. No panes are allocated and nothing is rendered.

External tools query the snapshot by invoking zellij pipe --name get-state, which returns a JSON document covering input mode, base mode, all tabs with their pane lists, and session metadata. The primary consumer is Modaliser, which uses the state to drive a context-aware command overlay for zellij and dispatches actions back via the zellij action CLI.

The plugin targets wasm32-wasip1 and is pinned to zellij 0.44.1. Install via scripts/install, add the load_plugins entry to config.kdl, and grant the ReadApplicationState permission on first load.