dsh-companion

Native DSH client shells such as dsh-native frequently need workspace lists, live session state, and completion alerts without loading the full Harness Web UI or scraping the DOM. dsh-companion plugs into that gap: as a Cordis host module it injects into the DSH runtime and exposes three cache-free, read-only JSON endpoints for workspaces, live sessions, and individual session summaries, plus a reconnectable SSE notification stream covering successful turns, blocked turns, errors, token-limit hits, aborts, pending questions, and tool approvals. All data arrives as structured JSON directly to the shell with no browser-rendering dependency.

A dedicated settings card (Settings, then Plugins, then DSH Companion notifications) lets you filter alert kinds and subagent events at the source, with changes applied instantly through the Harness settings service. When dsh-better-sidebar is also installed, an optional Images tab appears in the plus menu, gathering every image in the current conversation — user attachments, assistant image blocks, and images surfaced by tools like read_image — into a clickable thumbnail gallery with a full-size lightbox. Every response uses explicit field projection so internal Harness objects are never serialized wholesale, and all requests are gated by trusted-host and same-origin checks.

Cross-machine browsing is a standout capability: when the DSH Native bridge is active, Companion merges workspaces and live sessions from the local runtime and every saved server into the stock WorkspaceBrowser sidebar, tagging remote rows with their server name while keeping search, expansion, hover cards, and the Ungrouped bucket intact. Mutating row actions on remote entries are deliberately inert, preserving strict read-only semantics. The plugin is ideal for developers building project and session metadata displays inside dsh-native or similar shells, wiring custom notification panels, or managing workspaces across multiple servers from a single interface.