telepath-computer/television
The missing GUI for personal agents. Television gives you and your agent a visual space for creating and working with artifacts. - telepath-computer/television
94 stars · 7 forks
README
Television
Television is the missing GUI for your personal agent. It gives you a visual space for creating and working with artifacts in collaboration with your agent. It works with any agent and any model. To use Television, you talk to your agent like you normally do. But instead of just producing textual chat responses, your agent can now create visual artifacts, put them on your Television, and modify them over time. Artifacts are persistent, malleable, and can even be interactive. They can display documents, data, visualizations, live web pages, even your vibe-coded apps and interfaces.
Prerequisites To use Television, you must have an agent harness installed. Television works with any harness that supports skills and file access, but we specifically recommend Hermes, OpenClaw, Pi, Claude Code, or Codex. Your agent should be installed on a machine that is running either Linux or macOS. Agents running on Windows are not currently supported. Installation Simply download and install our macOS app. When you launch the app it will walk you through connecting it to your agent. If you aren't on a Mac, you can use our experimental browser-based interface, but you'll still need an agent that's running on Linux or macOS. Just paste the following prompt into your agent: Read the entire Television admin guide at https://television.run/install.md and help me get Television installed.
Your agent will ask you a series of questions and then will set everything up. When it's done, it will give you an URL you can use to access your TV from any platform using your browser. How it works Television consists of three parts: a server, a skills bundle, and a client app.
The server is lightweight and is installed on the same machine where your agent runs. It enables your agent to communicate with the TV client app. The skills bundle is automatically installed during setup. It teaches your agent how TV works, how to create artifacts on your TV, and how to modify the artifacts and the TV environment. With these skills installed, your agent will often know when to respond to your requests by creating a TV artifact; in other cases, you can simply ask it to "put that on my TV." The client app is a "sidecar" that you use alongside whatever chat interface you're already using to talk to your agent. We offer an installable Electron app for macOS users, but you can also access your Television on any platform via your browser. (The Electron app has a few advantages, chief among them the ability have artifacts that load external web pages.)
Building from source Requires Node.js 24 with npm >=11.5 <12. git clone https://github.com/telepath-computer/television.git cd television npm install npm run build npm run link tv serve To run the Television server as a persistent system service: tv serve --persist Community Join us on Discord for questions, feedback, and announcements! Contributing This project is open source, but uses a spec-driven development process that we haven't opened to outside contributors yet. For now, bug reports and feedback are welcome here on GitHub. If you're interested in contributing, please join our Discord; we'd love to chat. About Telepath We're a software company working on interfaces for the next era of personal computers. We believe fundamental changes in personal computing have always been accompanied by new interface metaphors that help bring those changes to the masses. Television is just the beginning. Learn more about us. License MIT © 2026 Telepath (Unternet PBC)