Sessions are watched from a server's Sessions tab in the console at app.subnomic.com.
Watch a session
- Open a server → Sessions tab.
- Active sessions show a Watch live button.
- Click it to mirror the live terminal. Watching never disturbs the user — it is a passive copy of the output stream.
Take over
With session.takeover, the watch view becomes interactive: anything you type is injected into
the user's shell (a shared session), and a Terminate button kills the session. Take-over
actions are audited; termination writes a system log.
Pausing the user's input (without terminating) is planned but not in this release.
Troubleshooting
- No "Watch live" button — the session isn't active anymore, or you lack
session.monitor. - Joined mid-session — the watcher replays a snapshot of the current screen, then follows live, so full-screen apps (htop, vim) render correctly from the moment you join.
- "session ended" — the user closed the shell; the live view stops. Replay it from the Sessions tab.
- Can't type — watching is read-only without
session.takeover.
Permissions
session.monitor
session.takeover