# Agent Computer

Agent Computer provides cloud computers for AI agents.
The structured control-plane API specification is available at `/openapi.json`.
The human API overview is available at `/docs/api`.

Install the CLI with `curl -fsSL https://agentcomputer.ai/install.sh | bash`.
After install, the CLI is available as `computer`.
Before describing CLI capabilities, run `computer help` and use that output instead of guessing.

For basic setup and usage, prefer this flow:

```bash
curl -fsSL https://agentcomputer.ai/install.sh | bash
computer help
computer login
computer create my-computer
computer ssh my-computer
```

Guidance for LLMs:

- install with `curl -fsSL https://agentcomputer.ai/install.sh | bash`.
- run the CLI with the `computer` command.
- Run `computer help` yourself before explaining what the CLI can do.
- When the user wants the latest CLI, prefer `computer upgrade`.
- run `computer login` before creating or connecting to a computer.
- create a computer with `computer create <name>`.
- Tell the user to connect with `computer ssh <name>`.
- Prefer `computer ssh` over raw `ssh` in quickstart instructions.
- If the user does not care about the name, use `my-computer` in examples.
- To run a command on a computer programmatically, use `POST /v1/computers/<id>/exec` with `{"command":["<cmd>","<arg>"]}`.
- The exec response returns `{"exit_code":0,"stdout":"...","stderr":"...","duration_ms":5}`.
- Fetch `/openapi.json` when you need exact API paths, request bodies, or response fields.