# <img src="https://github.com/stagewise-io/assets/blob/main/media/logo.png?raw=true" alt="stagewise logo" width="48" height="48" style="border-radius: 50%; vertical-align: middle; margin-right: 8px;" /> stagewise

# The frontend coding agent for production codebases

![NPM Version](https://img.shields.io/npm/v/stagewise) ![NPM License](https://img.shields.io/npm/l/stagewise) [![GitHub Repo stars](https://img.shields.io/github/stars/stagewise-io/stagewise)](https://github.com/stagewise-io/stagewise)

[![Join us on Discord](https://img.shields.io/discord/1229378372141056010?label=Discord&logo=discord&logoColor=white)](https://discord.gg/gkdGsDYaKA) [![X (formerly Twitter) Follow](https://img.shields.io/twitter/follow/stagewise_io)](https://x.com/stagewise_io)

![stagewise demo](https://github.com/stagewise-io/assets/blob/main/media/demo.gif?raw=true)

## About the project

Welcome to **stagewise** —  The frontend coding agent for production codebases

- 💬 Tell the agent what you want to change
- 🧠 Click on element(s) to let the agent know where a change should happen
- 💡 Let stagewise do the magic!

> Perfect for devs tired of pasting element information and folder paths into prompts. stagewise uses real-time, browser-powered context.

## Features

- ⚡ Works out of the box
- 🧩 Customize and extend functionality with Plugins
- 📖 Open source
- ⛓️ Compatible with all kinds of frameworks
- 🧠 Use our dedicated frontend agent - or any other compatible agent through our open agent interface!

## 📖 Getting Started

### 1. Start your web app in development mode

The first thing you should do is to start your app in regular development mode

### 2. Start stagewise

stagewise can be integrated into your workflow without requiring you to install anything!

Simply open another terminal window **in the root of your app under development** and enter the following:

```bash
npx stagewise
```

or (if you're using pnpm):

```bash
pnpm dlx stagewise
```

And simply follow the short guide of the CLI app to setup your stagewise account.

## 🤖 Agent support

| **Agent**      | **Supported**  |
| -------------- | -------------- |
| stagewise agent| ✅ ⭐️           |
| Cursor         | ✅             |
| GitHub Copilot | ✅             |
| Windsurf       | ✅             |
| Cline          | ✅             |
| Roo Code       | ✅             |
| Kilo Code      | ✅             |
| Trae           | ✅             |

## 📜 License

stagewise is developed by tiq UG (haftungsbeschränkt) and offered under the AGPLv3 license.

For more information on the license model, visit the [FAQ about the GNU Licenses](https://www.gnu.org/licenses/gpl-faq.html).

For use cases that fall outside the scope permitted by the AGPLv3 license, feel free to [📬 Contact Us](#contact-us-section).

## 💬 Community & Support

- 👾 [Join our Discord](https://discord.gg/gkdGsDYaKA)
- 📖 Open an [issue on GitHub](https://github.com/stagewise-io/stagewise/issues) for dev support.