|
1 |
| -#Coding Agents |
| 1 | +#AICoding Agents |
2 | 2 |
|
3 | 3 | >[!NOTE]
|
4 | 4 | >
|
|
7 | 7 | >Please[open an issue](https://github.com/coder/coder/issues/new) or submit a
|
8 | 8 | >pull request if you'd like to see your favorite agent added or updated.
|
9 | 9 |
|
10 |
| -There are several types of coding agents emerging: |
| 10 | +Coding agents are rapidly emerging to help developers tackle repetitive tasks, |
| 11 | +explore codebases, and generate solutions with increasing effectiveness. |
11 | 12 |
|
12 |
| --**Headless agents** can run without an IDE open and are great for rapid |
13 |
| - prototyping, background tasks, and chat-based supervision. |
14 |
| --**In-IDE agents** require developers keep their IDE opens and are great for |
15 |
| - interactive, focused coding on more complex tasks. |
| 13 | +You can run these agents in Coder workspaces to leverage the power of cloud resources |
| 14 | +and deep integration with your existing development workflows. |
16 | 15 |
|
17 |
| -##Headless agents |
| 16 | +##Why Run AI Coding Agents in Coder? |
18 | 17 |
|
19 |
| -Headless agents can run without an IDE open, or alongside any IDE. They |
20 |
| -typically run as CLI commands or web apps. With Coder, developers can interact |
21 |
| -with agents via any preferred tool such as via PR comments, within the IDE, |
22 |
| -inside the Coder UI, or even via the REST API or an MCP client such as Claude |
23 |
| -Desktop or Cursor. |
| 18 | +Coder provides unique advantages for running AI coding agents: |
24 | 19 |
|
25 |
| -| Agent| Supported Models| Coder Support| Limitations| |
26 |
| -|---------------|---------------------------------------------------------|---------------------------|---------------------------------------------------------| |
27 |
| -| Claude Code ⭐| Anthropic Models Only (+ AWS Bedrock and GCP Vertex AI)| First class integration ✅| Beta (research preview)| |
28 |
| -| Goose| Most popular AI models + gateways| First class integration ✅| Less effective compared to Claude Code| |
29 |
| -| Aider| Most popular AI models + gateways| In progress ⏳| Can only run 1-2 defined commands (e.g. build and test)| |
30 |
| -| OpenHands| Most popular AI models + gateways| In progress ⏳ ⏳| Challenging setup, no MCP support| |
| 20 | +-**Consistent environments**: Agents work in the same standardized environments as your developers. |
| 21 | +-**Resource optimization**: Leverage powerful cloud resources without taxing local machines. |
| 22 | +-**Security and isolation**: Keep sensitive code, API keys, and secrets in controlled environments. |
| 23 | +-**Seamless collaboration**: Multiple developers can observe and interact with agent activity. |
| 24 | +-**Deep integration**: Status reporting and task management directly in the Coder UI. |
| 25 | +-**Scalability**: Run multiple agents across multiple projects simultaneously. |
| 26 | +-**Persistent sessions**: Agents can continue working even when developers disconnect. |
| 27 | + |
| 28 | +##Types of Coding Agents |
| 29 | + |
| 30 | +AI coding agents generally fall into two categories, both fully supported in Coder: |
| 31 | + |
| 32 | +###Headless Agents |
| 33 | + |
| 34 | +Headless agents can run without an IDE open, making them ideal for: |
| 35 | + |
| 36 | +-**Background automation**: Execute repetitive tasks without supervision. |
| 37 | +-**Resource-efficient development**: Work on projects without keeping an IDE running. |
| 38 | +-**CI/CD integration**: Generate code, tests, or documentation as part of automated workflows. |
| 39 | +-**Multi-project management**: Monitor and contribute to multiple repositories simultaneously. |
| 40 | + |
| 41 | +Additionally, with Coder, headless agents benefit from: |
| 42 | + |
| 43 | +- Status reporting directly to the Coder dashboard. |
| 44 | +- Workspace lifecycle management (auto-stop). |
| 45 | +- Resource monitoring and limits to prevent runaway processes. |
| 46 | +- API-driven management for enterprise automation. |
| 47 | + |
| 48 | +| Agent| Supported models| Coder integration| Notes| |
| 49 | +|---------------|---------------------------------------------------------|---------------------------|-----------------------------------------------------------------------------------------------| |
| 50 | +| Claude Code ⭐| Anthropic Models Only (+ AWS Bedrock and GCP Vertex AI)| First class integration ✅| Enhanced security through workspace isolation, resource optimization, task status in Coder UI| |
| 51 | +| Goose| Most popular AI models + gateways| First class integration ✅| Simplified setup with Terraform module, environment consistency| |
| 52 | +| Aider| Most popular AI models + gateways| In progress ⏳| Coming soon with workspace resource optimization| |
| 53 | +| OpenHands| Most popular AI models + gateways| In progress ⏳ ⏳| Coming soon| |
31 | 54 |
|
32 | 55 | [Claude Code](https://github.com/anthropics/claude-code) is our recommended
|
33 | 56 | coding agent due to its strong performance on complex programming tasks.
|
34 | 57 |
|
35 |
| ->Note: Any agent can run in a Coder workspace via our |
36 |
| ->[MCP integration](./headless.md). |
| 58 | +>[!INFO] |
| 59 | +>Any agent can run in a Coder workspace via our[MCP integration](./headless.md), |
| 60 | +>even if we don't have a specific module for it yet. |
| 61 | +
|
| 62 | +###In-IDE agents |
| 63 | + |
| 64 | +In-IDE agents run within development environments like VS Code, Cursor, or Windsurf. |
| 65 | + |
| 66 | +These are ideal for exploring new codebases, complex problem solving, pair programming, |
| 67 | +or rubber-ducking. |
| 68 | + |
| 69 | +| Agent| Supported Models| Coder integration| Coder key advantages| |
| 70 | +|-----------------------------|-----------------------------------|--------------------------------------------------------------|----------------------------------------------------------------| |
| 71 | +| Cursor (Agent Mode)| Most popular AI models + gateways| ✅[Cursor Module](https://registry.coder.com/modules/cursor)| Pre-configured environment, containerized dependencies| |
| 72 | +| Windsurf (Agents and Flows)| Most popular AI models + gateways| ✅ via Remote SSH| Consistent setup across team, powerful cloud compute| |
| 73 | +| Cline| Most popular AI models + gateways| ✅ via VS Code Extension| Enterprise-friendly API key management, consistent environment| |
| 74 | + |
| 75 | +##Agent status reports in the Coder dashboard |
| 76 | + |
| 77 | +Claude Code and Goose can report their status directly to the Coder dashboard: |
37 | 78 |
|
38 |
| -##In-IDE agents |
| 79 | +- Task progress appears in the workspace overview. |
| 80 | +- Completion status is visible without opening the terminal. |
| 81 | +- Error states are highlighted. |
39 | 82 |
|
40 |
| -Coding agents can also run within an IDE, such as VS Code, Cursor or Windsurf. |
41 |
| -These editors and extensions are fully supported in Coder and work well for more |
42 |
| -complex and focused tasks where an IDE is strictly required. |
| 83 | +##Get started |
43 | 84 |
|
44 |
| -| Agent| Supported Models| Coder Support| |
45 |
| -|-----------------------------|-----------------------------------|--------------------------------------------------------------| |
46 |
| -| Cursor (Agent Mode)| Most popular AI models + gateways| ✅[Cursor Module](https://registry.coder.com/modules/cursor)| |
47 |
| -| Windsurf (Agents and Flows)| Most popular AI models + gateways| ✅ via Remote SSH| |
48 |
| -| Cline| Most popular AI models + gateways| ✅ via VS Code Extension| |
| 85 | +Ready to deploy AI coding agents in your Coder deployment? |
49 | 86 |
|
50 |
| -In-IDE agents do not require a special templateas they are not used in a |
51 |
| -headless fashion. However, they can still be run in isolated Coder workspaces |
52 |
| -and reportactivityto the CoderUI. |
| 87 | +1.[Create a Coder templatefor agents](./create-template.md). |
| 88 | +1. Configure your chosen agent with appropriate API keys and permissions. |
| 89 | +1. Start monitoring agentactivityin the Coderdashboard. |
53 | 90 |
|
54 | 91 | ##Next Steps
|
55 | 92 |
|
56 | 93 | -[Create a Coder template for agents](./create-template.md)
|
| 94 | +-[Integrate with your issue tracker](./issue-tracker.md) |
| 95 | +-[Learn about MCP and adding AI tools](./best-practices.md) |