coder-workspaces

---
name: coder-workspaces
description: Manage Coder workspaces and AI coding agent tasks via CLI. List, create, start, stop, and delete workspaces. SSH into workspaces to run commands. Create and monitor AI coding tasks with Claude Code, Aider, or other agents.
metadata:
  openclaw:
    emoji: "🏗️"
    requires:
      bins: ["coder"]
      env: ["CODER_URL", "CODER_SESSION_TOKEN"]
---

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

   coder whoami
   

Workspace Commands

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

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

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
• 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
• Coder CLI
• Coder Tasks