Skip to main content

About environments

Environments provide a consistent workspace for agents to run commands and execute code. An environment includes your repositories, toolchain, and Cosmos dependencies like Auggie. You can host your environment on Augment’s cloud sandboxes, or use self-hosted daemons to use your own virtual machine infrastructure or laptop. The fastest way to experience Cosmos is to run the daemon on a development machine you already have configured, like your laptop.

Getting started

Cloud environmentSelf-hosted daemon
Where it runsAugment infrastructureYour machine (laptop, virtual machine, devbox)
SetupConfigure with repos, tools, and secretsRun auggie daemon on the host
Network accessConfigured egress onlySame as host
ConcurrencyUnlimitedBounded by the number of daemons you’ve connected
Persistence between sessionsNew each sessionsDisk and other state persists
Cost modelBilled per minute of uptimeNo additional costs
Best forMost workflows. Reproducible, isolated, scales with the team.Local-network access, custom hardware, regulated data that can’t leave your premises.

Cloud environments

A cloud environment is a reproducible image that Cosmos uses with each session. You build it once by choosing a base image, selecting repositories, set environment variables, and install dependencies and every session that targets it starts from that snapshot. Read more about cloud environments or create a new environment.

Self-hosted daemons

A daemon is a long-running Cosmos process on a machine you operate, virtual or physical. Sessions targeted at the daemon execute on that machine and have access to its CPU, disk, and network. Use daemons when the work needs to happen somewhere specific like your laptop, a VPC-bound virtual machine, a Mac mini that handles iOS builds, or a virtual devbox. Read more about self-hosted daemons.