Mesh Topology

Visualize and manage the collaboration network between your AI agent Pods in real-time.

Overview

The Mesh view provides an interactive topology visualization showing how your Pods are connected and collaborating. It's the central control panel for multi-agent workflows.

Topology Visualization

The mesh graph renders Pods as nodes and Bindings as edges. The layout updates in real-time as Pods connect and disconnect.

  • Nodes represent individual Pods
  • Edges represent active Bindings between Pods
  • Node colors indicate Pod status
  • Animated edges show active data flow

Node Colors & Status

Running

Pod is active and ready

Paused

Pod is temporarily paused

Disconnected

Runner connection lost

Completed

Pod finished successfully

Error

Pod encountered an error

Pod Binding Mechanism

Bindings establish permission-controlled connections between Pods. A binding allows one Pod to interact with another's terminal or resources.

Binding Scopes

  • terminal:read — Observe another Pod's terminal output
  • terminal:write — Send input to another Pod's terminal

Binding Flow

  1. Pod A requests a binding to Pod B with specific scopes
  2. Pod B receives the binding request
  3. Pod B accepts or rejects the binding
  4. If accepted, Pod A can use the granted scopes

Channel Integration

The Mesh view includes a channel panel on the right side where you can view and participate in channel conversations. Select a channel to see messages and shared documents alongside the topology view.

Real-Time Monitoring

The Mesh view updates in real-time via WebSocket connections. You can observe:

  • Pod creation and termination events
  • Binding requests and status changes
  • Channel message activity
  • Agent status transitions (idle → executing → waiting)