> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codewire.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspaces overview

> Understanding workspaces in CodeWire

**Workspaces** are development environments running inside your Coder instance. Each workspace is an isolated container with your tools, code, and configuration.

## Key concepts

| Concept       | Description                                                            |
| ------------- | ---------------------------------------------------------------------- |
| **Template**  | A blueprint that defines what software and tools are in a workspace    |
| **Owner**     | The organization member who created the workspace                      |
| **Status**    | The current state: running, stopped, starting, etc.                    |
| **Resources** | Infrastructure backing the workspace (compute, storage)                |
| **Agents**    | Processes inside the workspace that provide access (SSH, web terminal) |

## Workspace lifecycle

```
(Create from template) → Starting → Running → Stopped
                                       ↕
                                    Restarting
```

Workspaces can be started, stopped, and restarted. When stopped, persistent storage is kept but compute resources are released.

## Creating workspaces

There are two ways to create workspaces:

### AI-powered launch (from Codewire)

Use the **Launch** feature in the Codewire sidebar to create a workspace from a repo URL. AI analyzes your repository and configures the workspace automatically.

See [Launch a workspace](/getting-started/launch-workspace) for the full guide.

### From the Coder dashboard

1. Open your Coder dashboard via the **Open Coder** button
2. Choose a template
3. Name your workspace and configure parameters
4. Click **Create Workspace**

### From the CLI

```bash theme={null}
cw launch github.com/your-org/your-repo
```

## Viewing workspaces from Codewire

The Codewire dashboard shows all workspaces in the sidebar (nested under each resource) and in the workspaces table on the resource detail page. From there you can:

* See workspace names, owners, and statuses
* Click through to the [workspace detail page](/workspaces/manage-workspaces)
* Connect via IDE, terminal, VS Code, or web