Subshell Docs

Share a subshell

Grant other users access to a subshell you own.

Before you start

Only the owner can change sharing. The recipient needs an account on the same instance. Administrators need a sharing grant to view or control someone else's session. Only the owner can change its shares.

Grant access

  1. In the server dashboard's sidebar, choose Subshells. Open the ⋯ menu on your session's card or row and choose Share….
  2. In Search people…, search by email or name and choose a recipient, or choose Everyone.
  3. Select View or View + edit from the access dropdown, then select Add. Repeat for other recipients.
  4. Review the listed recipients and their access levels, then select Save.
Sharing dialog with Everyone granted View access, permission dropdowns, and a searchable recipient picker.
Select an access level for each recipient, then save the grants. Select the image to enlarge it.

Everyone means signed-in accounts on the instance, not anonymous visitors.

AccessWhat it allows
ViewRead session details, captured output, and the live terminal.
EditView access plus input, rename, restart, and terminate through the API.
OwnerManage sharing, notification preferences, and permanent deletion.

For SSH subshells, only the owner can type in the terminal. Recipients can view output even when their share grants edit access.

What recipients see

Terminal disclosure

View access exposes terminal output, including any secrets displayed there. Edit access also allows input into the running process, except in SSH subshells, where input remains owner-only.

Attached viewers can see other viewers' device names and terminal dimensions. Notifications remain owner-targeted and aren't added by a sharing grant.

Revoke access

Remove the relevant grants in the sharing dialog. Saving changes reconnects recipients' open terminals and checks their current access. A removed recipient can no longer read or type; someone changed from Edit to View reconnects with a read-only terminal. Your own terminal stays connected. Commands already sent may finish. An agent's pane token can list shared sessions, but it can't inspect or change another user's session through that grant.

Next steps

Read Access model and Communication security.

Edit on GitHub

Last updated on

On this page