Agents
Agents can create Computers, install dependencies, run tests and serve an application at its HTTPS address for your team to review.
On this page
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 to use a coding agent in the default image.
Applications the agent builds can use the Computer's HTTPS address. 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 to return to it after disconnecting.
Bulk create and clone
#Give agents separate workspaces for parallel jobs in one pool. A pool can have 10 creates or copies in progress per unit of capacity, up to 160. The size of a batch depends on the pool's available create slots and storage.
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, 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.
heaven create --pool web --count 3
heaven create --pool web --count 3 --copy buildHeaven tools
#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 or the local CLI server.
Agents that use a shell can also call the Heaven CLI. Applications can use the HTTP API.
Access
#An agent can request access for you to approve. To limit what an agent can do, give it a restricted API key for the commands and Computers it needs. Separate keys let you revoke each agent's access independently.
Service credentials
#Attach integrations so an agent can clone private GitHub repositories, pull images or call a model API while Heaven holds the credentials.