Astra Shell DocumentationDownload for macOS
Documentation Current: Shells across devices

Documentation / Everyday use / Shells across devices

EVERYDAY · SHELL

Continue one shell from different devices.

A shell is an interactive terminal retained by the remote host. Devices enter and render it; they do not determine whether it remains alive.

Lifecycle

Creating a shell creates a server-side Terminal that owns the PTY, process, and authoritative terminal state. Closing a client window removes its Attachment; it does not automatically terminate the Terminal.

Create Terminal→Attach device→Disconnect→Attach again

Disconnect and resume

After a network change, device sleep, or client restart, the client finds the Terminal by canonical UUID and receives a complete current state. The remote task does not need to be recreated on every connection.

Multiple devices

A computer and phone can enter the same shell and see the same server-authoritative state. One Controller owns input and resize at a time; other Attachments remain visible as Viewers and can safely take over when needed.

Restart boundaries

  • Client exit or network loss: the Terminal keeps running.
  • Managed gateway restart: an existing user worker can keep the Terminal.
  • User-worker or full-server restart: running Terminals are not currently restored from disk.