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:
- •
Install the CLI from Coder CLI docs
- •
Set environment variables:
bashexport CODER_URL=https://your-coder-instance.com export CODER_SESSION_TOKEN=<your-token> # Get from /cli-auth
- •
Test connection:
bashcoder 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 jsonand 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
- •Auth failed: Verify CODER_URL and CODER_SESSION_TOKEN are set, then run
coder login - •Version mismatch: Reinstall CLI from your Coder instance