Coder Workspaces

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:

   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](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)