REFERENCE · FAQ
Frequently asked questions.
Connections and shells
Does closing the client end the remote process?
No. The daemon or user worker keeps the PTY after an Attachment disconnects.
Why does reconnecting not create a new terminal?
The client stores the Terminal's canonical UUID, attaches to the same object, and receives authoritative state.
Devices and input
Can a computer and phone enter at the same time?
Yes. Multiple Attachments can view the same shell, but only the current Controller owns input and resize.
How do I move control to another device?
Takeover grants a new input lease. Fencing rejects late operations from the old lease.
History and files
Is history a plain-text log?
No. History shares the complete cell model with the viewport, preserving wide characters, style, wrapping, and logical lines.
Will file transfer freeze the shell?
Files/1 uses independent low-priority streams, avoiding direct transport-level head-of-line blocking of terminal interaction.
Deployment and compatibility
How is a gateway restart different from a server restart?
An existing worker can continue through a Managed gateway restart. A worker or full machine restart ends current runtime Terminals.
Can short IDs drive automatic reconnection?
Do not rely on them. Short IDs are for human input during one worker lifecycle; persistent integrations must store canonical UUIDs.