Guides

Short answers to specific questions about Hotline Computer, kept beside the manual.

Each guide is also served verbatim as Markdown, at its address with .md in place of the trailing slash.

Using it

Desktop — What is on the computer's screen: the top bar, where windows go, the job observer, the Activity window and a terminal of your own.
Viewer — The page that shows the computer's screen live, how taking control works, and the socket and file routes behind it.
Workspaces — How a project's toolchain gets onto the computer with Nix, where it is kept, and why there is no apt or sudo.

Security

Passkeys — How a passkey is made for the agent with your approval, how it signs in, and where its private key lives.
Secrets — How the computer holds your secrets by name, where each kind goes, what redaction does, and what it does not stop.

Reference

Contract — What makes something a valid computer, what is inside the image, and how it starts.
HTTP routes — Every route the computer serves, which ones need the token, and the settings that change where and how it listens.

Development

Building — Building the image from source, the checks a change has to pass, and where each part of the code lives.