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.
Quickstart
Cosmos walks you through a guided onboarding flow to connect your tools, configure your environment, and start your first session. Integration steps can each be skipped and completed later from Settings.Connect GitHub
Click “Connect GitHub” to install the Augment Code GitHub App. This allows an administrator to select which repositories Cosmos can access.What this unlocks:
- Agents can open and review pull requests
- Full codebase context for every session
- CI monitoring and auto-fix
Connect Slack (Optional)
Click “Connect Slack” to authorize Cosmos to read and post in channels. The administrator specifies which channels Cosmos has access to.What this unlocks:
- Agents can collaborate in team channels
- Notifications land where your team works
- Teammates can follow agent progress
Connect Linear (Optional)
Click “Connect Linear” to allow Cosmos to access your projects, tickets, and events — including label changes such as moving a ticket from Backlog to In Progress.What this unlocks:
- Agents can work with issues and projects
- Project context follows every agent session
- Updates can connect back to your roadmap
Pick Where Your Agents Run
Choose one of two options:
| Option | Description |
|---|---|
| Self Hosted (Quickest) | Run on your laptop, VM, or server with a single command. It is the fastest way to access your repos and dependencies. |
| Cloud | Augment hosted machines. Start with a pre-built docker image or bring your own, then connect your repos to get started. |
Choose a Starting Environment (Cloud only)
If you chose Cloud, pick a base image to start from. You can customize it later or bring your own.
| Environment | Description |
|---|---|
| Cosmos Default | Ubuntu 24.04 with Python 3.12 and Node.js 22 installed |
| TypeScript 6.0 | Dev Container running Debian 12 with TypeScript 6.0 and Node 22 |
| Go 1.24 | Official Go 1.24 development environment with Node 22 |
| PHP 8.4 | Official PHP 8.4 development environment with Node 22 |
| Ruby 3.4 | Official Ruby 3.4 development environment with Node 22 |
| Rust 1.95 | Official Rust 1.95 development environment with Node 22 |
Add Repositories
A dropdown lets you select which repositories to clone into your environment. These are the repos shared via the GitHub integration. Add multiple repos to let Cosmos work across projects — you can add more later. Click “Next” when done, or “Skip for now” to continue without selecting repos.
Name Your Environment
Give your environment a name you’ll recognize later (e.g.
weather-app-repo). Optionally add a description that will appear on the environments list (e.g. Pre-configured with Python 3.12, NumPy, and Jupyter). Click “Create Environment” when ready.Cosmos provisions your environment automatically. A progress dialog shows each stage:- ✅ VM started
- ⏳ Cloning repositories…
- ⏳ Creating snapshot…
- ⏳ Finishing up…
Pick Your Experts
Choose one or more Experts to install. A great place to start is PR Author, which owns a GitHub PR from open through merge — implementing changes, monitoring CI, and responding to review feedback until the PR is merged.