Home / Docs / Getting started
Start

Getting started

This guide takes you from nothing to a first working result. It takes about ten minutes. You need a computer with macOS, Windows or Linux, and either an API key from a model provider or a local model.

Video: Getting started (2:54)

1. Install the app

Open a terminal and paste the command for your system. It downloads the app and puts it with your other applications.

macOS and Linux
curl -fsSL https://vibecode.surf/install.sh | sh
Windows (PowerShell)
irm https://vibecode.surf/install.ps1 | iex

2. Sign in

Open the app. The first screen asks you to sign in. You do this once on each computer.

The sign-in screen
  1. Type the email and password of your account.
  2. Press Sign in.
  3. No account yet? Press Create an account. Forgot your password? sends a reset link.

Your projects, chats and API keys stay on your computer. The account only keeps the app up to date and unlocks your plan.

3. Connect a model

The app does not come with a model. You connect one: a hosted provider with an API key, or a local model that runs on your computer. The welcome screen shows a Connect a model card until you have done this.

The welcome screen
  1. Open a folder that already holds a project.
  2. Or type a name and press Create to start an empty project.
  3. Or paste a repository address and press Clone.
  4. Connect a model opens Settings.

The full steps, with links to where each provider hands out keys, are in Connect a model provider.

4. Open a project

A project is a folder on your computer. Agents can read and change files only inside that folder. Each project keeps its own agents, chats, plan and usage totals.

5. Find your way around

The main window with a project open
  1. The project bar. Each square is a project; + adds one.
  2. Agent tabs. Each tab is one agent with its own chat. + adds an agent.
  3. The message box. You type requests here.
  4. The four views: Code, Preview, Docs and Plan.
  5. The side panel switches between files, search, Git and history.
  6. Settings. To its left are search and the cost of this project; to its right, your account.

6. Send your first request

Click in the message box, describe the result you want, and press Enter. Describe the result, not the steps: what it does, who it is for, and how it should look.

Example requestBuild a one-page site for a neighbourhood bakery: a hero, today's bakes, opening hours and where to find us. Warm colours, plain HTML.
The buttons under the message box
  1. Attach files. You can also drag files in or paste an image.
  2. Tasks: ready-made requests you can pick from.
  3. The model this agent uses.
  4. How hard the model thinks before it answers.
  5. Agent settings: name, role, condense, delete.
  6. Dictate a message with your microphone.
  7. Compare: run the request with two models.
  8. Send. While the agent works, this becomes Stop.

The agent shows each step as a card: the files it reads and writes and the commands it runs. Before it runs a command, it asks you.

Where to go next