Skip to main content

Mesh Terminal

The Mesh Terminal gives you a browser terminal into any live agent session on your mesh. No VPN, no SSH keys, no local tmux — just open the dashboard and attach.

What it's for​

  • Watch a build. See exactly what the agent is doing, step by step.
  • Debug. When an agent is stuck or going in circles, attach and see its current context.
  • Intervene. Send a keystroke, hit Ctrl-C, redirect the agent to something new.
  • Pair. Two humans can attach to the same session simultaneously.

Opening a terminal​

From the mesh dashboard:

  1. Click a node in the node list.
  2. Click Terminal.

You're now attached to that node's agent session. Type to send input; output streams in real time.

Tiled view​

For mesh-wide oversight, switch to Tiled mode. Every active agent session on the network renders as a small terminal pane side by side. One glance tells you which agents are busy, which are idle, and which need attention. Click any pane to expand it to full view.

Session safety​

  • Read-only attach. By default, attaching is read-only so you can observe without interfering.
  • Take control. Explicitly switch to interactive mode to send input.
  • Detach cleanly. Closing the browser tab or clicking Detach leaves the agent session running. The agent never stops because a human left.

Permissions​

Mesh Terminal respects the mesh role policy — the ability to attach (read-only or interactive) is configurable per role. See the mesh Policy panel in the dashboard.

Next​

  • Observe — A lighter-weight view of agent activity without attaching to the terminal
  • The Gram Agent — The agent you're attaching to