Skip to content

Commit 5a7d531

Browse files
authored
docs: edit the ai agents doc (coder#17521)
general edit and adding some highlights as I work through the section [preview](https://coder.com/docs/@ai-coder-edit/ai-coder/agents) --------- Co-authored-by: EdwardAngert <17991901+EdwardAngert@users.noreply.github.com>
1 parent 9dea568 commit 5a7d531

File tree

1 file changed

+71
-32
lines changed

1 file changed

+71
-32
lines changed

docs/ai-coder/agents.md

Lines changed: 71 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Coding Agents
1+
# AI Coding Agents
22

33
> [!NOTE]
44
>
@@ -7,50 +7,89 @@
77
> Please [open an issue](https://github.com/coder/coder/issues/new) or submit a
88
> pull request if you'd like to see your favorite agent added or updated.
99
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.
1112

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.
1615

17-
## Headless agents
16+
## Why Run AI Coding Agents in Coder?
1817

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:
2419

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 |
3154

3255
[Claude Code](https://github.com/anthropics/claude-code) is our recommended
3356
coding agent due to its strong performance on complex programming tasks.
3457

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:
3778

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.
3982

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
4384

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?
4986

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.
5390

5491
## Next Steps
5592

5693
- [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

Comments
 (0)