Skip to main content

protean-subagent-viewer

❖ Communityv0.1.2★ 0

Desktop · by aska-digital · added · updated

Read-only Hermes Desktop pane for live and past delegated subagent workers.

Open in Hermes Desktop
hermes plugins install protean-subagent-viewer
Repository ↗Reviewed source @ facbb14 ↗Documentation ↗

README

From the reviewed commit facbb14 ↗; it updates when the author re-pins.

Subagent Viewer — Hermes Desktop (MVP)

A read-only Subagent Viewer pane for Hermes Desktop. It turns the agent's async subagent fan-out into a live card view: every spawned worker shows up as its own card with its goal, model, status, streaming thinking, latest tool line, and accumulated output — plus an Active/Past view toggle and a Copy output for forward button for JIT handoff.

This is the MVP subset of a larger in-development fan-out plugin (Chief of Staff). The viewer slice is deliberate: the user verified LIVE that viewing spawned subagents works perfectly, while the steer / interrupt / orchestrator-control features were not yet reliable. This fork keeps the verified viewer and strips everything else. It observes and copies only — it never steers, interrupts, spawns, or mutates the orchestrator session.

Features

  • Live worker cards — one card per spawned subagent, keyed by subagent_id, showing:
    • goal + status badge (running / done / interrupted / errored)
    • worker model (read-only, delegation-resolved)
    • streaming thinking (collapsible, capped ~2KB)
    • latest tool line
    • accumulated output preview (every subagent.text chunk appended, never overwritten) with a show-all toggle
  • Active/Past toggle — split the view between running workers and finished/interrupted/errored ones. All workers stay in state; only the render is filtered.
  • Full-output copy — "Copy output for forward" grabs the worker's complete final answer, extracting the full final_response from the orchestrator's live session history and falling back to the event summary, then the last tool results, then the accumulated buffer.
  • Ownership-gated viewing — follows the active session id; cards stream for the orchestrator that spawned the fan-out.

Install

The plugin root is profile-aware — copy plugin.js into the desktop plugin root of the profile you run:

# ACTIVE profile root (e.g. halakukhan) — the one the desktop loads
mkdir -p ~/.hermes/profiles/halakukhan/desktop-plugins/subagent-viewer/
cp plugin.js ~/.hermes/profiles/halakukhan/desktop-plugins/subagent-viewer/plugin.js

Then find Subagent Viewer in the ⌘K palette (PLUGINS header) and open the right-hand pane. Each plugin.js is fs-watched, so edits reload live.

Usage

  1. In the orchestrator session, post a delegate_task fan-out. Worker cards appear live as the subagents spawn.
  2. Watch: goal + status badge, streaming thinking, latest tool line, and accumulated output.
  3. Toggle Active/Past to review finished workers.
  4. Copy: "Copy output for forward" puts a worker's full final answer on your clipboard for handoff.

Empty state (no active workers) explains the flow.

Requirements

  • Hermes backend v0.21.0+ exposing the subagent.* event stream (incl. summary and output_tail on subagent.complete) and a live worker list. The pane ladders between session.info (carrying active) and delegation.status — whichever the backend serves.
  • Workers are REAL subagents spawned by delegate_task. This plugin never spawns anything; it observes and copies.
  • No telemetry. All state is local to the running desktop process.

Scope guards

  • Does not touch the room log / group-chats localStorage.
  • Does not auto-spawn, steer, or interrupt anything.
  • No telemetry, all local.

More by aska-digital

All 5 plugins by aska-digital →
protean-ordaprompt❖ Community★ 2

Jev-style comparative classifier for OrdaPilot. It compares all topic labels and session choices in one batch, including new-topic, ambiguous, and new-session options. It uses calibrated score and margin gates, weighs continuity against context cost and contamination, and abstains when uncertain. OpenRouter is optional for provisional new-label proposals and disabled by default.

Automation
protean-model-sync❖ Community★ 1

Fleet-wide provider and model presets with CLI and Hermes Desktop support. Disclosure — writes model/provider keys into the config.yaml of the profiles you select (backup taken first).

Models
cognition❖ Community★ 0

Cognition session-end memory — facts regex-extracted from your messages at session end, stored in a local SQLite queue and JSON log under one repo label, with fetch-first merge, per-entry provenance, and budgeted prefetch (tools: cognition_search, cognition_status, read-only cognition_dream). Disclosure — saves verbatim excerpts (up to 400 chars) of your own messages that match preference/decision phrases in plain local files under HERMES_HOME/cognition/ (SQLite queue, JSON commit log) and re-injects them into later prompts sent to your model provider; the author name is read from ~/.gitconfig; the plugin makes no network calls of its own.

Memory
voicestudio❖ Community★ 0

Client for the local VoiceStudio text-to-speech app (debpalash/VoiceStudio): speak short text, design or clone voices, browse voices, render chaptered long-form audio, dub videos, and check server status. Six tools with mirrored slash commands plus a bundled skill. Disclosure — sends the text, script files, videos and voice samples you point it at to the VoiceStudio server you configure (default http://127.0.0.1:3900, plain HTTP) and saves the returned audio under HERMES_HOME/plugin-data/voicestudio; no credentials, no telemetry, no self-update.

Voice

← Back to the catalog · catalog built Oct 15, 2026