> ## 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.

# Quickstart

> Get your first workspace running in 5 minutes

Two paths to get started — web dashboard or CLI.

## Prerequisites

* An **invite code** (Codewire is in private beta)
* After account creation, **2FA setup is mandatory** — you'll be redirected to configure it before accessing the dashboard

## Web quickstart

### 1. Create your account

1. Go to [codewire.sh/signup](https://codewire.sh/signup)
2. Enter your invite code, name, email, and a password (minimum 12 characters)
3. Verify your email, then set up 2FA with an authenticator app

<Note>
  Save your backup codes — they're shown only once and are your fallback if you lose access to your authenticator app.
</Note>

### 2. Create an organization

1. From the [dashboard](https://codewire.sh/dashboard), click **New Organization**
2. Enter a **name** and **slug** for your organization
3. Click **Create**

After creating your org, a **setup checklist** guides you through the next steps: creating a resource, connecting GitHub, and more.

### 3. Add a Coder resource

1. Inside your organization, click **Add Resource**
2. Select **Coder** as the resource type
3. Choose a **plan** (all plans include a 14-day free trial)
4. Enter a **slug** — this becomes your Coder URL: `your-slug.codewire.sh`
5. Click **Create Resource**

<Info>
  If this is your first resource, you'll be redirected to Stripe Checkout to set up billing.
</Info>

### 4. Wait for provisioning

Codewire provisions a dedicated Coder deployment. This typically takes **2-5 minutes**.

The resource detail page shows a provision timeline with real-time progress.

### 5. Launch a workspace

Once your resource shows **Running**:

1. Click **Launch** in the sidebar
2. Enter a repo URL and click **Analyze** — AI detects your language, framework, and services
3. Review the detection results and adjust options if needed
4. Click **Launch Workspace**

Or open your Coder dashboard directly via **Open Coder** and use the admin credentials to sign in.

### 6. Connect GitHub (recommended)

1. Go to **Secrets** in the sidebar
2. Set your **GitHub Token** for private repo access

Or set up the full GitHub App integration from your resource settings.

### 7. Invite your team (optional)

1. Go to your organization's **Settings** page
2. Click **Members**, enter an email and click **Invite**

## CLI quickstart

### 1. Install

```bash theme={null}
brew install codewiresh/codewire/codewire
```

Or use the install script:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/codewiresh/codewire/main/install.sh | bash
```

### 2. Set up

```bash theme={null}
cw setup
```

The interactive wizard walks you through: server URL, login, org selection, resource selection, and GitHub connection.

### 3. Launch a workspace

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

AI analyzes the repo and creates a workspace with the right tools and dependencies.

### 4. Run an agent

```bash theme={null}
cw run -- claude "fix the tests"
```

This SSHs into your workspace and starts a persistent session.

## What's next?

<CardGroup cols={2}>
  <Card title="Launch workspaces" icon="rocket" href="/getting-started/launch-workspace">
    Learn about the AI-powered workspace launcher.
  </Card>

  <Card title="CLI platform commands" icon="terminal" href="/cli/platform">
    Full reference for platform-mode CLI commands.
  </Card>

  <Card title="Resource dashboard" icon="gauge" href="/resources/resource-dashboard">
    Learn what's on the resource detail page.
  </Card>

  <Card title="Connect GitHub" icon="github" href="/settings/github-integration">
    Set up GitHub authentication for your Coder instance.
  </Card>
</CardGroup>