Skill: developmentcats/coder-workspaces (version 1.5.5)

--- 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: ```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)

path: CHANGELOG.md
content: # Changelog

All notable changes to the Coder Workspaces skill will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [1.5.5] - 2026-02-06

### Changed
- Restructured skill to follow standard CLI documentation patterns
- Setup section now shows environment configuration (matches hass-cli style)
- Commands no longer reference environment variables directly

## [1.5.4] - 2026-02-06

### Changed
- Install instructions now point only to official Coder docs

## [1.5.3] - 2026-02-06

### Added
- Context note clarifying commands run in isolated Coder workspaces, not host

## [1.5.2] - 2026-02-06

### Changed
- Rewrote skill for agent (not user) as audience
- Agent now attempts CLI install/auth fixes before asking user
- Preset handling: try without, use default if exists, ask user only if needed

### Removed
- Brew install metadata (agent learns install from Coder docs)

## [1.5.1] - 2026-02-06

### Changed
- Task states timing now notes dependency on template configuration

## [1.5.0] - 2026-02-06

### Removed
- `scripts/setup.sh` — CLI installation is now user responsibility (see docs)
- `scripts/authenticate.sh` — login command documented in SKILL.md instead
- `scripts/list-presets.sh` — presets visible in Coder web UI

### Changed
- Skill now follows standard pattern: documents usage, doesn't install software
- Added `metadata.openclaw.install` for brew install hint
- No scripts remain — pure documentation skill

## [1.4.1] - 2026-02-06

### Changed
- `scripts/setup.sh` now downloads binary directly instead of executing remote install script

### Security
- Removed shell script piping pattern that triggered security scanners

## [1.4.0] - 2026-02-06

### Added
- `scripts/authenticate.sh` — Login with session token (separate from install)

### Changed
- `scripts/setup.sh` now only installs/updates CLI (no longer handles auth)
- Setup and auth are now independent tools for targeted troubleshooting

## [1.3.1] - 2026-02-06

### Added
- `scripts/setup.sh` — Install CLI from instance URL and verify authentication in one step

### Changed
- README now instructs installing CLI from your Coder instance URL (ensures version match)
- README restructured around the setup script workflow
- SKILL.md references setup script for initial setup

### Security
- Removed inline curl/API examples from SKILL.md (credential pattern flagged by security scanner)
- SKILL.md now references helper scripts without exposing token-handling patterns
- Helper scripts retained as tools (not agent-loaded content)

## [1.3.0] - 2026-02-06

### Added
- Helper script `scripts/list-presets.sh` to discover available presets for templates
- Complete "Task Creation Workflow" section with step-by-step instructions

### Changed
- Restructured AI Coding Tasks section around the full workflow

## [1.2.1] - 2026-02-06

### Changed
- Cleaned up description to remove implementation details
- Simplified README with cleaner formatting
- Replaced table with bullet list for task timing
- Removed redundant sections and improved readability

## [1.2.0] - 2026-02-06

### Changed
- Restructured skill to separate agent instructions from setup documentation
- Setup instructions moved to README.md (for humans)
- SKILL.md now assumes coder CLI is pre-installed and authenticated

### Removed
- Helper script with curl commands (security scanner flagged patterns)
- Reference files with API examples (redundant with official Coder docs)

### Security
- Removed all curl and credential-sending patterns from agent-loaded files
- Skill no longer contains install or authentication instructions

## [1.1.0] - 2026-02-06

### Added
- Initial public release of Coder Workspaces skill for OpenClaw
- Workspace lifecycle management: list, create, start, stop, restart, delete
- SSH and command execution in workspaces
- AI coding agent task management for Claude Code, Aider, Goose, and others
- Helper script (coder-helper.sh) for common operations
- Comprehensive CLI command reference documentation
- Coder Tasks deep-dive guide
- Setup guide with agent workflow checklist
- Troubleshooting guide for authentication issues
- GitHub Actions workflow for automated ClawHub publishing on tagged releases


path: README.md
content: # Coder Workspaces Skill for OpenClaw

Manage [Coder](https://coder.com) workspaces and AI coding agent tasks from your OpenClaw agent.

## Features

- **Workspaces**: List, create, start, stop, restart, delete
- **Remote Commands**: SSH into workspaces and run commands
- **AI Tasks**: Create and manage Coder Tasks with Claude Code, Aider, Goose, etc.

## Prerequisites

1. Access to a Coder deployment (self-hosted or Coder Cloud)
2. Coder CLI installed
3. Environment variables configured

## Setup

### 1. Install Coder CLI

Install from your Coder instance to ensure version compatibility:

```bash
# Visit your instance's CLI page for instructions
# https://your-coder-instance.com/cli
```

Or via Homebrew (may not match server version):

```bash
brew install coder
```

See [Coder CLI docs](https://coder.com/docs/install/cli) for all options.

### 2. Set Environment Variables

Add to your OpenClaw config (`~/.openclaw/openclaw.json`):

```json
{
  "env": {
    "CODER_URL": "https://your-coder-deployment.com",
    "CODER_SESSION_TOKEN": "your-session-token"
  }
}
```

Get a token at `https://your-coder-deployment.com/cli-auth` or `/settings/tokens`.

### 3. Authenticate

```bash
coder login --token "$CODER_SESSION_TOKEN" "$CODER_URL"
```

### 4. Verify

```bash
coder whoami
```

## Install the Skill

```bash
clawhub install coder-workspaces
```

## Usage

Ask your OpenClaw agent things like:

- "List my Coder workspaces"
- "Start my dev workspace"
- "Create a task to fix the auth bug"
- "Check status of my running tasks"
- "SSH into backend and run the tests"

## Links

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

## License

MIT


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)