|
1 |
| -# Coding Agents |
| 1 | +# AI Coding 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 template as they are not used in a |
51 |
| -headless fashion. However, they can still be run in isolated Coder workspaces |
52 |
| -and report activity to the Coder UI. |
| 87 | +1. [Create a Coder template for agents](./create-template.md). |
| 88 | +1. Configure your chosen agent with appropriate API keys and permissions. |
| 89 | +1. Start monitoring agent activity in the Coder dashboard. |
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) |
0 commit comments