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

> Local Mode

# Connect with Cursor, Windsurf or VS Code

# Overview

Local Mode keeps your visual edits in Tempo and your code edits in an IDE **perfectly in-sync**.\
Choose the method that fits your workflow:

1. **NPX Command** – zero install, ideal for quick one-offs or CI 
2. **Local Mode Extension** – rich, two-way sync baked into VS Code, Windsurf, and Cursor

Both methods create a live copy of your Tempo project on disk; save in your editor and watch Tempo update in real time.

## Quick Video Walk-through

<iframe width="560" height="315" src="https://www.youtube.com/embed/0loQ68A6zP8?si=1-g3WmejXf7MppEj" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

## Option 1 · Sync with **npx tempo-sync**

Use this when you want to clone a Tempo project and run it locally without installing an extension.

1. Open your project at [**tempo.new**](http://tempo.new) and click the **terminal icon** in the top-right toolbar.
2. Copy the generated `npx tempo-sync …` command.
3. In your favourite IDE, open the built-in **Terminal**
4. Paste the command and hit **Enter**. Tempo will clone the project into a new folder install dependencies start the dev server.
5. Edit files, then **Save(** `⌘S` / `Ctrl+S`). Your changes push back to Tempo automatically.

## Option 2 · Sync with the **Local Mode Extension**

For day-to-day development you’ll want the richer experience of Local Mode inside VS Code, Windsurf, or Cursor.

### Installation

1. In Tempo, click the **IDE logo** (appears as a Cursor icon).
2. Pick your editor and hit **Download Extension**.\
   *VS Code Marketplace links coming soon.*
3. Reload your IDE when prompted.

## Next steps

* **Extension Marketplace** – VS Code | Windsurf | Cursor *(links coming soon)*
* **Try Tempo Now** – [tempo.new](http://tempo.new)

Happy building! Local Mode collapses the gap between *idea*, *design*, and *code* so your team can ship in half the time.
