Home / Docs / Use SuperDevAI

Desktop app

The SuperDevAI desktop app for Windows: chat with the agent, watch your app run in a live preview, approve changes and publish.

Workspaces

SuperDevAI works on one folder at a time: your workspace.

  • Building a new app? Start in an empty folder. The app creates its files there. One app per folder.
  • Working on existing code? Open the project's folder. The agent reads it before it changes anything.

If you ask for something before a folder is open, SuperDevAI asks you to choose one and then carries on with your request in the same conversation.

Simple and Dev modes

Simple modeDev mode
ForPeople who want the result, not the codeEngineers working in an existing repository
ExplanationsPlain languageTechnical, with files, commands and output
ApprovalsWorks on its own for routine stepsAsks before changing files or running commands

In both modes SuperDevAI always asks before publishing, pushing to Git, or deleting anything outside your project folder. See Approvals and safety.

Live preview

When you build or change a web app, it runs in the preview pane beside the chat and reloads as the agent works.

  • Opening a folder that already holds an app starts its preview.
  • Switch between desktop, tablet and phone sizes to check the layout.
  • Opening a project for the first time doesn't install its packages on its own. If they're missing, the preview says so, and installing is one click (or ask the agent).

The chat

  • Each step shows what the agent did: the command line it ran and the real output, the files it read, and the changes it made.
  • A status panel shows where the run is: what it's doing, what it found, what it will change, and whether that's applied and checked.
  • Messages you send during a run are queued. You can reorder or cancel them before they're answered.
  • Diagrams in answers (architecture, flows) are drawn as charts.

Conversations

Every conversation is saved, however it ends, including when you stop a run or close the app. Reopen one from Recents to see everything that was shown and carry on where you left off. The same conversations are available in VS Code and the command line.

If the app closes while a run is in progress, the conversation says the run was cut off when you reopen it, so you can ask again.

When the AI service is having trouble

If the model provider is unavailable (out of balance, rejecting a key, rate-limiting or overloaded), a notice appears above the chat saying what's wrong and since when. It disappears on its own as soon as calls succeed again. Your conversation is kept, so you can continue afterwards.

Built-in terminal

The desktop app has a terminal. In it, the superdevai command line is already set up and talks to the same agent as the app.

Updates

The app checks for updates on its own and downloads them in the background. When one is ready, a Restart to update button appears. The latest installer is always available from Download for Windows on the home page.