Introduction
# 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)