Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.stagewise.io/llms.txt

Use this file to discover all available pages before exploring further.

stagewise is a native desktop agentic IDE — not a web app or browser extension. Download it once and AI coding agents work directly on your filesystem.

Before you begin

  • A macOS, Windows, or Linux machine meeting the requirements below
  • Optional: a stagewise account for instant access to the managed model library. You can also bring your own API keys or run models locally

Step 1: Download stagewise

Download the latest version from stagewise.io.
PlatformRequirementsDownload
macOSmacOS 12 (Monterey) or later · Apple Silicon (arm64) or Intel (x64)DMG from stagewise.io
WindowsWindows 10 or later · 64-bit (x64)Installer from stagewise.io
LinuxUbuntu 20.04+, Debian 11+, or compatible · x64AppImage from stagewise.io

Step 2: First launch & onboarding

When you first open stagewise, an onboarding wizard walks you through three steps:
  1. Welcome — Introduction to the open source agentic IDE
  2. Authentication — Sign in with your stagewise account (email + one-time password) or skip to use your own keys
  3. Feature walkthrough — Guided overview of workspaces, slash commands, @mentions, design previews, and plugins

Step 3: Sign in or skip

You don’t need an account to use stagewise. Pick what works for you:
  • Sign in with email — Passwordless OTP authentication. Gets you instant access to the stagewise Account model library — a curated set of pre-configured models ready to use. No API keys needed.
  • Import your subscriptions — Already paying for Claude, GPT, Gemini, Kimi, Qwen, DeepSeek, GLM, or MiniMax? Bring your existing API keys and use them directly. Set up BYOK →
  • Go fully local — Run models entirely on your machine via Ollama or LM Studio. Zero external API calls, full data sovereignty. Connect a custom endpoint →

Step 4: Connect a workspace first

stagewise works best after you connect a project folder. The agent needs workspace access before it can read files, edit code, run commands, or review diffs. You can browse without a workspace, but coding workflows start with a connected folder.

What’s next

Quickstart

Connect a workspace and send your first prompt in under 5 minutes.

How agents work

Understand the agent loop and how AI coding agents operate on your code.