Getting Started with Cosmos

What is Augment Cosmos?

Cosmos runs your agents in the cloud. They read your repos, work in sandboxed VMs, and wake up on events from GitHub, Slack, Linear, PagerDuty, webhooks, and cron. You drive them from the webapp, your phone, or Slack — whichever surface you’re already in. You can build Automations inside Cosmos to put agents to work reviewing code as soon as PRs are created or assigning tickets to agents when new tickets are created.

Core Concepts

Concept	What it is
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.
Environment	A reusable virtual machine where your Experts run. Bundles a name, base image, repositories, environment variables, and visibility.
Capability	A bundle of tools or MCP servers that give an Expert a specific ability (CLI Tools, GitHub, Linear, Slack, 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.
↳ Skills	A reusable knowledge package (following agentskills.io) that provides specialized instructions or domain expertise to an Expert. Stored inside Files.
↳ 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.
Automation	A persistent, event-driven rule that tells Cosmos to launch an agent — or wake up a running one — whenever something happens in a connected services (GitHub, Linear, Slack, etc.).
Files	Objects stored in a virtual file system that Experts can read and write. Shared files are visible to all members of an Organization, while private files are only visible to the User who created them.

Questions about Cosmos?

Ask Cosmos Advisor — your go-to agent for navigating Cosmos. It can answer all your questions about Cosmos and set things up for you: connecting integrations, building Environments, creating Experts, and wiring Automations.

​What is Augment Cosmos?

​Core Concepts

​Questions about Cosmos?

What is Augment Cosmos?

Core Concepts

Questions about Cosmos?