# EmptyOS

> Your own computer in the cloud, built for agents.

EmptyOS gives you one persistent Linux computer at a name you choose. It starts empty; you put things on it yourself or through an agent. Computers are invitation-only for now.

The official workstation CLI is `empty`, installed from the `@emptyos/client` npm package. To connect to an existing computer, install the client locally and run `empty connect https://<computer-host>`; no provider account, DNS change, or local EmptyOS server is needed.

- [Agent instructions](https://emptyos.com/skills/emptyos-computer/SKILL.md): Read the actual shipped skill before installation or setup.

Each page below is markdown. The same path without `.md` is the HTML version.

## Start

- [Getting started](https://emptyos.com/docs/start.md): Install the client, create a computer, connect an agent.

## Use

- [Concepts](https://emptyos.com/docs/concepts.md): Computer, Home, Things, Projects, Data, hostnames, undo.
- [Put, clone, publish](https://emptyos.com/docs/publish.md): How software gets onto the computer and how it changes.
- [Sharing](https://emptyos.com/docs/sharing.md): Private by default. Share with named accounts or expose to everyone.
- [Updates](https://emptyos.com/docs/updates.md): Complete EmptyOS updates and local file reconciliation.
- [Trust and revocation](https://emptyos.com/docs/trust.md): What approving an agent grants, and how to revoke it.

## Reference

- [CLI reference](https://emptyos.com/docs/cli.md): Every empty command, from the same table as empty --help. Client 0.1.7, protocol 2.
- [The empty skill](https://emptyos.com/docs/skill.md): Read and install the agent skill that ships with the client.

## Optional

- [The pages above in one file](https://emptyos.com/docs/llms-full.txt): concatenated in this order; the overview is only this list.