coder-workspaces

TotalClaw 作者 totalclaw

通过 CLI 管理 Coder 工作区和 AI 编码代理任务。列出、创建、启动、停止和删除工作区。通过 SSH 进入工作区以运行命令。使用 Claude Code、Aider 或其他代理创建和监控 AI 编码任务。

安装 / 下载方式

TotalClaw CLI推荐

totalclaw skills install shop:totalclaw:totalclaw~developmentcats-coder-workspaces

cURL直接下载，无需登录

curl -fsSL https://skills.taituai.com/api/skills/totalclaw%3Atotalclaw~developmentcats-coder-workspaces/file -o developmentcats-coder-workspaces.md

## 概述（中文）

通过 CLI 管理 Coder 工作区和 AI 编码代理任务。列出、创建、启动、停止和删除工作区。通过 SSH 进入工作区以运行命令。使用 Claude Code、Aider 或其他代理创建和监控 AI 编码任务。

## 原文

# Coder Workspaces

Manage Coder workspaces and AI coding agent tasks via the coder CLI.

> Note: Commands execute within isolated, governed Coder workspaces — not the host system.

## Setup

Before using coder CLI, configure authentication:

1. Install the CLI from [Coder CLI docs](https://coder.com/docs/install/cli)

2. Set environment variables:
   ```bash
   export CODER_URL=https://your-coder-instance.com
   export CODER_SESSION_TOKEN=<your-token>  # Get from /cli-auth
   ```

3. Test connection:
   ```bash
   coder whoami
   ```

## Workspace Commands

```bash
coder list                              # List workspaces
coder list --all                        # Include stopped
coder list -o json                      # JSON output

coder start <workspace>
coder stop <workspace>
coder restart <workspace> -y
coder delete <workspace> -y

coder ssh <workspace>                   # Interactive shell
coder ssh <workspace> -- <command>      # Run command in workspace

coder logs <workspace>
coder logs <workspace> -f               # Follow logs
```

## AI Coding Tasks

Coder Tasks runs AI agents (Claude Code, Aider, etc.) in isolated workspaces.

### Creating Tasks

```bash
coder tasks create --template <template> --preset "<preset>" "prompt"
```

- **Template**: Required. List with `coder templates list`
- **Preset**: May be required. Try without first. If creation fails with "Required parameter not provided", get presets with `coder templates presets list <template> -o json` and use the default. If no default, ask user which preset.

### Managing Tasks

```bash
coder tasks list                        # List all tasks
coder tasks logs <task-name>            # View output
coder tasks connect <task-name>         # Interactive session
coder tasks delete <task-name> -y       # Delete task
```

### Task States

- **Initializing**: Workspace provisioning (timing varies by template)
- **Working**: Setup script running
- **Active**: Agent processing prompt
- **Idle**: Agent waiting for input

## Troubleshooting

- **CLI not found**: See [Coder CLI docs](https://coder.com/docs/install/cli)
- **Auth failed**: Verify CODER_URL and CODER_SESSION_TOKEN are set, then run `coder login`
- **Version mismatch**: Reinstall CLI from your Coder instance

## More Info

- [Coder Docs](https://coder.com/docs)
- [Coder CLI](https://coder.com/docs/install/cli)
- [Coder Tasks](https://coder.com/docs/ai-coder)