# Agents

URL: https://heaven.dev/docs/agents
Updated: 2026-11-21

Agents can create Computers, install dependencies, run tests and serve an application at its HTTPS address for your team to review.

An agent can run inside a Computer or work with Computers remotely through Heaven's MCP tools.

## Agent workspaces

An agent's repository, dependencies and saved work remain on the Computer's disk across stops and restarts. Root access lets it install packages and configure services.

Open a [terminal in the Computer](https://heaven.dev/docs/connecting) to use a [coding agent in the default image](https://heaven.dev/docs/computers#default-image).

Applications the agent builds can use the Computer's [HTTPS address](https://heaven.dev/docs/networking#http-and-tls). You can open the application in your browser while the agent works on it.

## Sessions and saved work

Start an interactive agent in a [`tmux` session](https://heaven.dev/docs/connecting#sessions) to return to it after disconnecting.

## Bulk create and clone

Give agents separate workspaces for parallel jobs in one [pool](https://heaven.dev/docs/pools). A pool can have 10 creates or copies in progress per [unit of capacity](https://heaven.dev/docs/pools#sizing-a-pool), up to 160. The size of a batch depends on the pool's [available create slots and storage](https://heaven.dev/docs/limits#request-rates).

Use `--count` to have Heaven choose the names. Add `--copy` to start each Computer from the same source Computer's disk. To copy a [snapshot](https://heaven.dev/docs/snapshots#creating-a-copy), use `--copy` with `--snapshot`. To choose names, use `--names` with a comma-separated list or pass the names as separate arguments in place of `--count`.

```sh
heaven create --pool web --count 3
heaven create --pool web --count 3 --copy build
```

## Heaven tools

[MCP](https://heaven.dev/docs/mcp) gives an agent tools to create and manage Computers, run commands inside them and transfer files. The agent client can run on your own machine and use a Computer as its remote working environment.

Connect through the [hosted MCP endpoint](https://heaven.dev/docs/mcp#hosted-server) or the [local CLI server](https://heaven.dev/docs/mcp#local-server).

Agents that use a shell can also call the [Heaven CLI](https://heaven.dev/docs/cli). Applications can use the [HTTP API](https://heaven.dev/docs/http-api).

## Access

An agent can request access for you to [approve](https://heaven.dev/docs/security#agent-sign-in-approval). To limit what an agent can do, give it a [restricted API key](https://heaven.dev/docs/security#credentials) for the commands and Computers it needs. Separate keys let you revoke each agent's access independently.

## Service credentials

Attach [integrations](https://heaven.dev/docs/integrations) so an agent can clone private GitHub repositories, pull images or call a model API while Heaven holds the credentials.
