Skip to main content

​
Step 1: Download stagewise

Download the latest version of stagewise from stagewise.io. The application is available for macOS, Windows, and Linux.

​
Step 2: First launch & onboarding

When you first open stagewise, the onboarding flow walks you through:
  1. Welcome — A brief introduction to what stagewise does
  2. Authentication — Sign in with your stagewise account (email + OTP) or skip to use BYOK mode
  3. Demo — A guided walkthrough of the core features
  4. Suggestions — Optional recommended configuration

​
Step 3: Connect a workspace

Open your local development server in stagewise like any URL. When you connect a workspace folder, the agent gets access to your project files. The agent automatically scans for:
  • WORKSPACE.md — An auto-generated project analysis file in .stagewise/
  • Skills — Custom agent instructions in .stagewise/skills/ or .agents/skills/
  • AGENTS.md — An optional project-level instruction file (opt-in)

​
Step 4: Start chatting

Use the sidebar chat panel to give the agent instructions. You can:
  • Type natural language requests
  • Select DOM elements from the browser to attach as context
  • Reference files using @ mentions
  • Review and accept/reject code changes inline

​
What’s next?

Best practices

Learn tips for effective agent interactions.

BYOK setup

Configure your own API keys and providers.

Models & providers

Choose which AI models to use.

Diff review

Understand how to review agent code changes.