Documentation Index
Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt
Use this file to discover all available pages before exploring further.
What is Augment Cosmos?
Use Cosmos to run cloud-based agents that read your repos, execute in sandboxed VMs, and act on events from GitHub, Slack, Linear, PagerDuty, webhooks, and schedules. Sessions are accessible from the web, mobile, and Slack.Core Concepts
Cosmos is built from a small set of composable primitives:| Concept | What it is |
|---|---|
| Environment | A reusable virtual machine where your Experts run. Bundles a name, base image, repositories, environment variables, and visibility. |
| Expert | A reusable template that defines an agent’s behavior. It includes a name, instructions, environment, system prompt, model, and which capabilities it has access to, triggers and events it can react to, and visibility — either shared or private. |
| ↳ Capability | A bundle of tools or MCP servers that give an Expert a specific ability (GitHub, Linear, Web Access, etc.). |
| ↳ Trigger | A structured notification that turns a real-world event into an Expert action. Sources include GitHub (a new PR), Linear (a status change), Slack (a new message), PagerDuty (a P0 incident), a cron schedule, or a custom webhook. |
| ↳ Visibility | Controls whether an Environment or Expert is private to you or shared across your organization. |
| Session | The conversation with an Expert — every message, turn, and tool call. Sessions can be private or shared, and are accessible from the web, mobile, and Slack. |