---
title: "Cool Computers guide"
description: "The official Cool Computers guide to connecting your agent, the CLI, the HTTP API, public addresses, and computer inboxes."
canonical: "https://www.cool.computer/docs"
last_updated: "2026-11-20"
---
# Cool Computers guide

> The official Cool Computers guide to connecting your agent, the CLI, the HTTP API, public addresses, and computer inboxes.

Agents: the [developer reference](/docs/api-reference/developer-reference.md) has the HTTP, CLI, and MCP workflow on one page, and the [OpenAPI contract](/openapi.json) has every operation.

Cool Computers puts what you and your agent make online under a name. A computer named `bakery` has the public address `bakery.cool.computer` and the inbox `bakery@mail.cool.computer`. It starts as a published site with no VM, and gets an always-on VM when the work needs a server, a bot, or a schedule.

A site stays on your account until you delete it. A computer with a VM needs Pro: when Pro ends, its VM stops and the computer is deleted 7 days later unless Pro returns first ([pricing](/pricing) has the details). One made by `cool publish` without signing in is deleted, with its site, after 24 hours unless you [claim it](/docs/use/cli#publish-a-site). Its files, name, address, and inbox stay with it. Requests to its public address reach its published files until you expose an HTTP port; from then on they reach the program on that port.

## Start here

- [Quickstart](/docs/getting-started/quickstart): Put your first page online with your agent or the CLI.
- [Connect your agent](/docs/agents/overview): A setup page for each agent and chat app.
- [Install the CLI](/docs/agents/cli): Add the native `cool` command on macOS, Linux, or Windows.
- [Use the HTTP API](/docs/api-reference/overview): Operate computers from your own software.

## Other ways to connect

- Run [`ssh cool.computer`](/docs/agents/ssh) to open your account without installing the CLI.
- [Email a task](/docs/use/email) to the inbox attached to a computer.

## Current terms

Read the current [pricing](/pricing), [privacy policy](/privacy), and [terms](/terms). Signed-in limits come from `cool usage --json` or `GET /api/usage`.
