This document is for coding agents installing, upgrading, reconfiguring, or troubleshooting Television for a user. Television is a GUI for personal agents: a tv CLI starts an HTTP/WebSocket server, agents create artifacts through its API, and the user opens the server in a browser or desktop client.
Two roles run through this guide, and keeping them straight is the difference between a smooth setup and a confusing one:
- The agent administrator ("the agent") — you. You are the technical operator: you run the commands, choose the flags, read
tv status, and consult every reference in this document. This guide is written entirely for you; the user never reads it. - The user — the person the Television is for. Treat them as semi-technical: they know how they get to their own machine and how they want to watch their Television, but they should never have to see a flag, an IP address, or an auth toggle. You translate their plain answers into configuration o