#Quickstart

This walks you through creating your first chatspace and getting a live preview — start to finish, from your phone.

#Before you start

• Get the app. Download Chatspaces for iPhone or iPad ↗. (Android is on the way.)
• A GitHub account with at least one repository you want to work on.
• A Claude or ChatGPT account. You'll sign in to whichever agent you choose. Claude needs a paid plan (Pro or Max); Codex works on a free ChatGPT account. Usage runs on your own account — see what's required.

#1. Sign in with GitHub

Open the app and sign in with GitHub. This is how Chatspaces knows which repos you can work on. You're signing in to Chatspaces here — you'll sign in to Claude or Codex separately, the first time you use one.

#2. Create a chatspace

Tap the + button and:

• Pick a repo and branch. Choose an existing branch, or let Chatspaces start a fresh chatspaces/… branch so your work is isolated.
• Choose your agent — Claude or Codex. You can use a different agent per chatspace.
• Write a kickoff prompt — what you want done first. For example: "Add a health-check endpoint and a simple status page, then run the dev server."
• Optionally pick an environment (for secrets) and an idle-stop timeout.

Tap Create. Chatspaces claims a machine and clones your repo onto it. This usually takes a few seconds.

#3. Sign in to your agent (first time only)

The very first time you use Claude or Codex, you'll be asked to sign in:

• Claude shows a login link. Open it, approve, and you're connected.
• Codex shows a short device code and a link. Open the link, enter the code, and it connects itself.

Chatspaces can securely remember this so you don't sign in again on future chatspaces — see Signing in and Provider credentials.

#4. Drive it from the agent's app

When the chatspace is running, tap Open in Claude or Open in Codex. The conversation happens in that app — talk to the agent, watch it work, approve actions. Switch back to Chatspaces any time to see status, manage the machine, or grab your links.

See Driving from the apps for how this works in each app.

#5. Get a live preview

Ask the agent to run your app and expose it. For example:

"Run the dev server on port 3000 and give me a public link."

The agent starts your server and points the chatspace's public URL at it. You'll get an HTTPS link like your-repo.chatspaces.dev that you can open or share. Under the hood this is a small route file the agent writes — details in Live preview links.

#6. Commit, push, and come back later

Ask the agent to commit and open a pull request when you're happy. When you're done for now, just leave — Chatspaces auto-stops the machine after a while so you don't burn usage. Your files, branch, and progress are preserved. Tap Resume (or Open in…) to pick up exactly where you left off.

That's the whole loop. From here: