OpsDeck
Real-time constellation view of agent activity during team objectives.
Overview
OpsDeck is a QuoxCORE plugin that provides a real-time visual map of agent activity during team objectives. Rather than reading logs or polling status endpoints, you watch the work unfold on a zoomable constellation canvas. Each agent appears as a node in orbit around the QUOX orchestrator, with position, colour, and animation driven by live telemetry.
The plugin connects via Server-Sent Events (SSE) and updates continuously as agents receive tasks, begin execution, and report results. There is no polling interval. State changes appear the moment they happen.
Tier: Standard Price: $8 (one-time)
Constellation View
The primary interface is a canvas rendered in orbital layout. The QUOX orchestrator sits at the centre. Specialist agents are arranged in concentric rings radiating outward, grouped by role or capability.
Layout
- Centre node: The orchestrator that coordinates the current objective.
- Inner ring: Primary agents directly assigned to the active objective.
- Outer rings: Supporting agents, monitoring agents, and any idle members of the fleet.
Agents reposition dynamically as objectives change. When a new objective begins, assigned agents move inward; when they complete, they drift back to the outer rings.
Canvas Controls
The constellation canvas supports:
- Zoom: Scroll wheel or pinch gesture to zoom in and out.
- Pan: Click and drag to move the viewport across the canvas.
- Agent focus: Click any agent node to see its current task, recent actions, and connection metadata.
- Reset view: Double-click the centre node to reset zoom and pan to the default position.
Agent States
Each agent node displays one of four visual states, updated in real time via SSE events.
Idle
The agent is connected but has no active task. The node renders with a dim, steady glow and sits in an outer ring. Opacity is reduced but remains clearly visible.
Thinking
The agent has received a task and is processing. The node pulses with a slow breathing animation. A faint ring expands outward from the node at regular intervals, similar to a sonar ping.
Executing
The agent is actively running a tool, command, or workflow step. The node displays a scanning glow border -- a radar-sweep effect that rotates around the node perimeter. The speed and colour intensity of this sweep are driven by workload:
- Low load: Slow sweep, cool colour (blue-white).
- Medium load: Moderate sweep, warm colour (amber).
- High load: Fast sweep, hot colour (red-orange).
Complete
The agent has finished its assigned task. The node briefly flashes, then settles into a steady bright state before transitioning back to idle. A small checkmark indicator appears beside the node for a few seconds.
System Pulse Bar
A persistent status bar runs along the bottom of the OpsDeck view. It provides at-a-glance metrics for the current objective without requiring you to inspect individual agents.
The Pulse Bar displays four values:
| Metric | Description |
|---|---|
| Objective progress | Percentage of tasks completed within the active objective. Rendered as a horizontal fill bar. |
| Active agents | Count of agents currently in thinking or executing state. |
| Elapsed time | Wall-clock time since the objective was initiated. |
| Connection state | SSE connection health indicator -- connected, reconnecting, or disconnected. |
When multiple objectives run simultaneously, the Pulse Bar shows an aggregate view by default. You can pin a specific objective to the bar by selecting it from the objective list.
Multi-Objective View
OpsDeck supports monitoring more than one objective at a time. When multiple objectives are active, the constellation view partitions into segments. Each segment contains its own orchestrator centre and agent rings.
Behaviour
- Agents assigned to multiple objectives appear in each relevant segment, with a connecting line between their instances.
- The canvas auto-arranges segments to avoid overlap. You can also drag segments to reposition them manually.
- Selecting a single objective from the sidebar isolates that segment and hides the others.
- The Pulse Bar updates to reflect whichever objective is currently selected, or shows the aggregate if none is selected.
Limits
The constellation view handles up to 50 visible agent nodes at once without performance degradation. Beyond that, agents in the outer rings collapse into summary clusters that expand on hover.
SSE Events
OpsDeck receives all updates through a single SSE connection to the QuoxCORE event stream. The following event types drive the UI:
| Event | Trigger | UI Effect |
|---|---|---|
agent:state | Agent transitions between idle, thinking, executing, complete | Node animation and colour change |
agent:connect | Agent joins the fleet | New node appears in outer ring |
agent:disconnect | Agent leaves the fleet | Node fades out and is removed |
objective:start | New objective initiated | Constellation reconfigures; Pulse Bar resets |
objective:progress | Task within objective completes | Pulse Bar progress updates |
objective:complete | All tasks in objective finished | Brief completion animation across all assigned nodes |
objective:error | A task fails or an agent reports an error | Affected node flashes red; error badge appears |
Reconnection
If the SSE connection drops, the Pulse Bar connection indicator changes to "reconnecting" and OpsDeck attempts to re-establish the stream with exponential backoff. On reconnection, the server sends a full state snapshot so the UI rebuilds without missing any transitions.
UI Design
OpsDeck uses a glassmorphism visual style consistent with the QuoxCORE dashboard theme.
Visual Language
- Backdrop blur: All panels and the Pulse Bar use
backdrop-filter: blur()over a translucent background. This provides depth without obscuring the constellation canvas beneath overlaid controls. - Dark palette: The canvas background is near-black. Agent nodes, connection lines, and UI elements use light colours with carefully chosen opacity values (minimum 0.6 for any text or icon).
- Glow effects: The scanning border on executing agents and the sonar ping on thinking agents use box-shadow and radial-gradient techniques. These are GPU-accelerated and do not block the main thread.
- Typography: System font stack, consistent with the rest of QuoxCORE. Status labels on agent nodes use a monospace variant for clarity at small sizes.
Responsiveness
The constellation canvas scales to fill the available viewport. On smaller screens, the Pulse Bar condenses to show only progress and connection state, with the other metrics available on tap. The canvas remains fully zoomable and pannable at all breakpoints.
Accessibility
- Agent states are communicated through both colour and shape (animation pattern), so the display remains interpretable without relying on colour alone.
- The Pulse Bar values are exposed as live regions for screen readers.
- Keyboard navigation supports tabbing between agent nodes and pressing Enter to inspect.
Getting Started
- Install OpsDeck from the QuoxCORE plugin store.
- Enable the plugin in your dashboard settings.
- Open OpsDeck from the sidebar. The constellation will populate automatically once agents connect and an objective is active.
No additional configuration is required. OpsDeck reads agent and objective data from the existing QuoxCORE event stream.