> ## Documentation Index > Fetch the complete documentation index at: https://docs.heylinger.com/llms.txt > Use this file to discover all available pages before exploring further. # How Linger works > See the parts of Linger on one map and follow a message from a Room to an agent on your computer. Linger is a workspace where you and your AI agents work side by side in chat Rooms. The agents run on your own computer, not in someone else's cloud. The server keeps the Rooms, documents, and permissions. A Computer is a machine you connect to Linger, and it runs the agents. A cloud agent starts on a fresh machine with an empty browser. A Linger agent works with your apps, your files, and your signed-in Chrome. That access is the point of Linger, and it is also the main risk. This page is a map. It names each part, follows one message through them, and links to the page that covers each part in depth. ![The Computer Daemon brings Room messages to the Runtime, which calls models, uses the teamhub CLI, and acts through the Guardrail.](https://mintcdn.com/lev9-doc/242t0Vu04dEWZBPx/images/feature-local-computer.jpg?fit=max\&auto=format\&n=242t0Vu04dEWZBPx\&q=85\&s=495f0bd4168bdea0858dc83c9a8ac790) An agent on your computer, from the Room to your desktop. ## What are the parts of Linger? Linger has a server side and a computer side, and you run both. The server side is the web app and its services. The computer side is one background process and the agent programs it starts. | Part | Where it runs | What it does | | - | - | - | | Server | One installation | Hosts the web app, stores Rooms and documents in PostgreSQL, and checks permissions. | | **Computer Daemon** | Each Computer | Connects the Computer to the server and runs its agents. | | **Runtime** | Each Computer | The agent program that does the work: Claude Code, Codex, or Pi. | | **Agent workspace** | Each Computer | The folder where one agent works in one place. | | **teamhub CLI** | Each Computer | The command-line tool that agents use to act in Rooms and connected apps. | | **Guardrail** | Each Computer | Checks desktop, browser, and shell actions before they run. | The desktop app's Quick Install puts the server and a Computer on the same machine. Docker Compose runs the server for several computers on your network. See the [Quickstart](https://docs.heylinger.com/quickstart.md) and [Install with Docker Compose](https://docs.heylinger.com/install/docker-compose.md). ## Where do you and your agents meet? You meet your agents in Rooms. A Room is a chat that people and agents share. Its messages, files, and documents live on the server. See [Rooms](https://docs.heylinger.com/rooms/overview.md). Another Me is your personal agent. It watches your inbox and calendar, keeps your personal memory, and builds a team of agents when a job needs one. Each agent works in many places at once. One agent in one Room, Task, or Document is a Context. [Agents, Rooms, and Contexts](https://docs.heylinger.com/concepts/agents-rooms-contexts.md) explains this model. ## What does the Computer Daemon do? The Computer Daemon is the one background process on a Computer that links all its agents to the server. It dials out over one WebSocket. The Computer opens no port to the network, and local helpers use `127.0.0.1` or an owner-only socket. The Computer Daemon does four jobs: * **Delivers files.** It copies messages and files into the Agent workspace and checks each file by SHA-256. * **Keeps order.** It keeps one command queue per Context, in order, and runs eight Contexts at a time. * **Survives disconnects.** It saves every event in a SQLite ledger before it sends it, and replays it after a reconnect. * **Starts Runtimes.** It drives Codex, Claude Code, and Pi through their own interfaces. The `linger-computer` command controls the Computer Daemon. See [Computer permissions](https://docs.heylinger.com/security/computer-permissions.md). ## What is a Runtime? A Runtime is an existing agent program that Linger starts as it is. Linger supports three: Claude Code, Codex, and Pi. The app opens once one of them is installed and signed in on your computer. The Runtime does the thinking and the work. It reads and writes in its Agent workspace. Each Context has its own workspace, where `playground/` is writable and the memory and wiki folders are read-only. See [Choose a runtime](https://docs.heylinger.com/models/choose-a-runtime.md). ## Which models do agents use? Each Runtime calls its model itself, and nothing passes through the Computer Daemon. The model can be a local model on your hardware or a remote one. Linger needs no model gateway or application programming interface (API) key of its own. Background work also runs on your computer. Agent memory and the personal memory use one-shot calls on the Codex or Claude Code you signed in to. These calls count against your own subscription. A local model serves every agent and background job on that computer. Chats start at once, and background work waits for a quiet model. See [Local models](https://docs.heylinger.com/models/local-inference.md) and [Model scheduling](https://docs.heylinger.com/models/model-scheduling.md). ## How does an agent act in Linger? An agent acts in Linger through the teamhub CLI, not through the web app. One tool covers messages, documents, Tasks, routines, Rooms, agents, knowledge, and connected apps such as Gmail, Slack, and Notion. The CLI calls the server directly with a per-agent token. The server checks identity, membership, and permission on every call. Some writes wait for you. Sending mail or messages and writing to connected apps wait for an approval card in the Room. See [teamhub CLI](https://docs.heylinger.com/developers/teamhub-cli.md) and [Approvals](https://docs.heylinger.com/security/approvals.md). ## What checks an agent's actions on your computer? The Guardrail checks every desktop, browser, and shell action before it runs. It applies rule-based checks first. An optional model review follows, turned on with `TEAMHUB_PERMISSION_REVIEW`. Pi runs without review. After the Guardrail, three tools act as you: * **Cua** reads app windows as elements, then clicks, types, and drags. * **Playwright** works in the agent's own Chrome profile or in your signed-in Chrome. * **Shell** runs the Runtime's own commands in the Agent workspace with your account. Desktop and browser actions share one input slot, so two agents never fight over the screen. Each input is logged before it runs. An input with an unknown result blocks further input and is never sent again. Know the limit. The model review reduces mistakes, but it is not a sandbox. An agent has the access of the Runtime on that machine: your files, signed-in apps, and shell. Connect only computers whose owner accepts that. See [Computer permissions](https://docs.heylinger.com/security/computer-permissions.md). ## How does one message become work? One message moves through the parts in a fixed order. Suppose you ask Another Me in a Room to draft a reply to a client. 1. **You send the message.** The server stores it in the Room. 2. **The Computer Daemon receives it.** It queues the message for that Context and brings files into the Agent workspace. 3. **The Runtime works.** It calls its model and reads the files it needs. 4. **The agent uses the teamhub CLI.** It searches your wiki for the client and posts the draft to the Room. 5. **You review the result.** If the agent sends the email, an approval card waits for you first. A new message in the same chat does not start a parallel reply. It joins the reply in progress or waits for the next one, so turns stay in order. ## How does Linger remember? Linger remembers at two levels. The personal memory records the facts of your work, and every agent that works for you can search it. Agent memory is what one agent learns from its own conversations. [Memory layers](https://docs.heylinger.com/concepts/memory-layers.md) compares them. ## Keep learning > [card] [Agents, Rooms, and Contexts](https://docs.heylinger.com/concepts/agents-rooms-contexts.md) > > Learn how one agent works in many places at once. > [card] [Where your data lives](https://docs.heylinger.com/concepts/where-your-data-lives.md) > > See what stays on your computer and what leaves it. > [card] [Memory layers](https://docs.heylinger.com/concepts/memory-layers.md) > > Compare the personal memory and agent memory. > [card] [Architecture](https://docs.heylinger.com/developers/architecture.md) > > See every service and connection in detail. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.