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.
The fastest way to build or update an environment is to ask Cosmos Advisor to do it for you — and it’s strongly recommended over hand-editing the environment form. Describe your project in plain language and the Advisor picks the base image, syncs the right repositories, and installs your toolchain, rather than you configuring it by hand.

​
Getting started

​
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.