mirror of
https://github.com/coder/coder.git
synced 2025-07-10 23:53:15 +00:00
67 lines
2.1 KiB
Markdown
67 lines
2.1 KiB
Markdown
# Create a Coder template for agents
|
|
|
|
> [!NOTE]
|
|
>
|
|
> This functionality is in beta and is evolving rapidly.
|
|
>
|
|
> When using any AI tool for development, exercise a level of caution appropriate to your use case and environment.
|
|
> Always review AI-generated content before using it in critical systems.
|
|
>
|
|
> Join our [Discord channel](https://discord.gg/coder) or
|
|
> [contact us](https://coder.com/contact) to get help or share feedback.
|
|
|
|
## Overview
|
|
|
|
This tutorial will guide you through the process of creating a Coder template
|
|
for agents.
|
|
|
|
## Prerequisites
|
|
|
|
- A Coder deployment with v2.21 or later
|
|
- A template that is pre-configured for your projects
|
|
- You have selected an [agent](./agents.md) based on your needs
|
|
|
|
## 1. Duplicate an existing template
|
|
|
|
It is best to create a separate template for AI agents based on an existing
|
|
template that has all of the tools and dependencies installed.
|
|
|
|
This can be done in the Coder UI:
|
|
|
|
|
|
|
|
## 2. Add a module for supported agents
|
|
|
|
We currently publish a module for Claude Code and Goose. Additional modules are
|
|
[coming soon](./agents.md).
|
|
|
|
- [Add the Claude Code module](https://registry.coder.com/modules/claude-code)
|
|
- [Add the Goose module](https://registry.coder.com/modules/goose)
|
|
|
|
Follow the instructions in the Coder Registry to install the module. Be sure to
|
|
enable the `experiment_use_screen` and `experiment_report_tasks` variables to
|
|
report status back to the Coder control plane.
|
|
|
|
> [!TIP]
|
|
>
|
|
> Alternatively, you can [use a custom agent](./custom-agents.md) that is
|
|
> not in our registry via MCP.
|
|
|
|
The module uses `experiment_report_tasks` to stream changes to the Coder dashboard:
|
|
|
|
```hcl
|
|
# Enable experimental features
|
|
experiment_use_screen = true # Or use experiment_use_tmux = true to use tmux instead
|
|
experiment_report_tasks = true
|
|
```
|
|
|
|
## 3. Confirm tasks are streaming in the Coder UI
|
|
|
|
The Coder dashboard should now show tasks being reported by the agent.
|
|
|
|
|
|
|
|
## Next Steps
|
|
|
|
- [Integrate with your issue tracker](./issue-tracker.md)
|