# Quickstart

This walks you from zero to a working cloud workspace in about three minutes.

## 1. Create an environment in the dashboard

Open `https://dash.tabtabtab.ai`, sign in, and click `Create`. Choose an environment name, confirm your Git author name and email, and submit.

The Meta UI shows each provisioning step (EC2 launch, public IP assignment, Cloudflare DNS, runtime bootstrap, Traefik, TLS, and the TabTabTab IDE readiness check) so you can see what's happening while the VM comes up.

## 2. Open the Web IDE

When the environment is ready, click `Open`. On mobile, sign into the dashboard from your phone and tap `Open`, or scan the QR code from the dashboard on your computer.

## 3. Add a repository

In the Web IDE, click the plus button in the left sidebar, choose `Add Repository`, paste an HTTPS Git URL, choose a destination such as `~/workspace/my-app`, and continue. After the clone finishes, review detected env files in Secret Manager and paste any missing values.

## 4. Start working

Open a session, ask an agent to inspect or change the repo, and use the Review tab before committing. If the project has a dev server, start it and use `tabtabtab runtime preview <port>` (or the IDE preview button) to get a public URL you can open on any device.

## Optional CLI setup

Install the CLI when you want local terminal access, uploads, repo commands, or scripted setup:

```
curl -fsSL https://tabtabtab.ai/install.sh | sh
tabtabtab auth login
```

Create and select an environment from the CLI:

```
tabtabtab env create --name $(whoami)
tabtabtab env list
tabtabtab env use $(whoami)
tabtabtab env info
```

Use the dashboard to open the Web IDE. Use CLI attach commands when you want a local editor or SSH shell attached to the same cloud machine.

For non-interactive runs (CI, scripts, agents), pass the environment name, git author values, and telemetry behavior up front:

```
tabtabtab env create \
  --name $(whoami) \
  --git-user-name "tabtabtab Agent" \
  --git-user-email agent@example.com \
  --no-telemetry
```

Send local notes, docs, scripts, or assets into the workspace:

```
tabtabtab upload ./docs --to docs/
```

Stuck on any step? Email support@tabtabtab.ai with the environment name and what you saw.