BasicAgent

Terminal Sessions vs Terminal Workspaces

Terminal sessions are connections; terminal workspaces are persistent, resumable environments.

Published: 2026-01-04 · Last updated: 2026-01-04

A terminal session is a connection. A terminal workspace is a persistent environment you can resume across time.

Sessions

  • tied to a connection,
  • reset when the connection drops,
  • no output replay for offline gaps.

Workspaces

  • tied to durable session identity,
  • survive disconnects,
  • replay output on reconnect.

Why the distinction matters

If you treat your terminal as a session, you lose work every time the connection blips. If you treat it as a workspace, continuity becomes normal.