# Understanding computers reference **Page:** getting-started/computers/reference [Download Raw Markdown](./getting-started/computers/reference.md) --- # Understanding computers reference Lookup tables for [Understanding computers](/getting-started/computers/). ## Kit services Every computer created with Hoody Kit enabled (`hoody_kit: true`) includes the services below, and every Kit-enabled computer ships all of them. Each answers at its own URL, and only the service label changes: ``` https://PROJECT_ID-COMPUTER_ID-terminal-1.node-us.computers.hoody.com https://PROJECT_ID-COMPUTER_ID-files-1.node-us.computers.hoody.com https://PROJECT_ID-COMPUTER_ID-display-1.node-us.computers.hoody.com ``` | Capability | Service label | What it does | | :--- | :--- | :--- | | [Shell access](/kit/terminals/) | `terminal-1` | Persistent PTY sessions over REST and WebSocket. Sessions survive disconnects, and several people can attach to the same one. | | [File system](/kit/files/) | `files-1` | Read, write, move, search, upload, and extract archives on any absolute computer path over HTTP. With journaling enabled, it records eligible changes made through the service to local files and keeps qualifying text revisions for history and diffs, subject to exclusions, size limits and retention. | | [Database](/kit/sqlite/) | `sqlite-1` | SQLite over HTTP: multi-statement SQL transactions plus a JSON key-value store with TTL, compare-and-swap, change history, and rollback. Bare database names resolve under `/hoody/databases`. Hoody computers normally also allow absolute database paths elsewhere. | | [Desktop display](/kit/displays/) | `display-1` | An X11 desktop streamed to a browser tab. The API takes screenshots, sends clicks and keystrokes, manages windows, and reads or writes the clipboard. | | [Browser automation](/kit/browser/) | `browser-1` | Long-lived Chromium or Firefox instances driven by Playwright: navigate, screenshot, run JavaScript, and read cookies and console or network logs. Headless Chromium also renders PDFs, and Chromium instances accept CDP connections unless started with `useRemoteDebuggingPort=false`. Page console calls are recorded on instances started with `stealth=false`. | | [Script execution](/kit/exec/) | `exec-1` | Serves routable `.ts` or `.js` scripts in the scripts directory as HTTP endpoints. `pre.*` and `post.*` are middleware; when both extensions define the same route, `.ts` takes precedence. Saving a route script updates its endpoint without a build or deploy step. | | [AI agent (Hoody Agent)](/kit/agent/) | `agent-1` | The coding agent running inside the computer. Open it from a browser tab or the Hub's **Agent** panel; in a terminal, or in the hosted CLI that `ssh hoody.com` opens, `hoody agent prompt` sends it a task. The interactive agent reopens an available session when it can. `hoody agent prompt` starts a new session by default; `--continue` reuses the most recent one and `--session-id` picks an existing one. The HTTP API can create sessions, send prompts, and stream turns. | | [VS Code](/kit/code/) | `code-1` | The VS Code editor in a browser tab, working on the computer's filesystem, with terminals and a debugger. Extensions come from the Open VSX marketplace inside the editor, from an HTTP call, or from a directory in the computer. | | [HTTP composition](/kit/curl/) | `curl-1` | Sends HTTP requests from the computer, as one-off calls, background jobs, or scheduled runs, with cookie jars. It can also turn any POST, PUT, or DELETE request into a plain GET URL. | | [Background processes](/kit/daemons/) | `daemon-1` | Starts and supervises long-running programs, with a restart policy and, by default, stdout and stderr logs kept on disk. | | [Scheduled tasks](/kit/cron/) | `cron-1` | Adds, lists, and removes crontab entries for a system user. Managed entries can expire, and hand-written crontab lines stay untouched. | | [Desktop notifications](/kit/notifications/) | `n-1` | Shows and records desktop toasts on a computer display, sent with an HTTP call. A browser page on `n-1` that you keep open, with notification permission granted, also shows them as browser notifications. Once the page is closed, new notifications still reach devices that enabled [Web Push alerts](/api/kit/notification-server/push/). | | [Data streaming](/kit/pipe/) | `pipe-1` | Streams bytes from one HTTP sender to up to 256 receivers on a shared path. [Live broadcasts](/kit/pipe/#live-broadcast) let viewers join during the stream; `?ws` relays messages both ways between two peers. Browser pages send files, receive downloads and share a screen, camera or microphone. Nothing is written to disk. A viewer that joins a WebM live broadcast mid-stream starts at the next key Cluster, after the stream header; nothing before that is replayed. | | [Collaborative notebooks](/api/notes/) | `notes-1` | Notebooks of sections, pages, and database records with rich-text documents, comments, reactions, document snapshots, attachments, and live updates over WebSocket. Snapshots are taken by hand in Notes; API writes that patch or append to a document also try to take one automatically, at most every 5 minutes. A notebook, or one section, folder, page or database, can be downloaded as a ZIP of Markdown or HTML files. | | [File watching](/api/watch/) | `watch-1` | Watches paths with inotify and delivers create, modify, remove, and rename events over SSE, WebSocket, or paginated history, with resume after a disconnect. | | [App resolution](/api/run/) | `run-1` | Resolves an app name such as `firefox` to a ready shell command, searching Nix, pkgx, AppImage, OCI images, and manifests. It returns the command and does not launch it. | | [TCP tunneling](/kit/tunnel/) | `tunnel-1` | Publishes an HTTP or WebSocket server from your laptop on the computer's public URL, or brings a laptop TCP port into the computer's loopback. | | [Proxy access logs](/api/proxy-logs/) | `logs-1` | Read-only queries, statistics and a live SSE tail of retained proxy access logs for this computer, filterable by status level, method and service. Coverage depends on logging settings; requests to the logs service itself are excluded by default. | | [Outbound HTTP proxy](/kit/egress/) | `egress` | An HTTP proxy that sends requests out through the computer. Setting an upstream changes the exit IP without changing the client. | | [Virtual machines](/kit/vm/) | `vm-1` | Runs QEMU virtual machines with KVM inside the computer: create from a template or installer image, start and stop, snapshot and export, and watch the screen on a display. Needs `/dev/kvm`, which [KVM passthrough](/foundation/servers/virtual-machines/) gives a computer on a dedicated server only. | [The Hoody Kit](/kit/) documents each service in depth.