Get started with Workbench

Check the Workbench download page for the macOS, Windows x64 and Ubuntu 24.04 x86-64 installers. You can use your existing Codex or Claude Code account.

Install Workbench

On macOS, open the disk image and drag Umide Workbench to Applications. On Windows, run the MSI installer.

On Ubuntu 24.04 x86-64, open a terminal in the folder containing the downloaded package and run this command. Then open Umide Workbench from your applications.

sudo apt install ./Umide-Workbench-Linux-x86_64.deb

Connect an agent and open a project

On first launch, the setup screen detects installed coding agents. Install Codex or Claude Code there if needed, then sign in through the provider. Open a project folder and start a conversation.

Choose the project folder for edits in place or an isolated Git copy for a separate task. The Files, Terminal, Mobile and Web buttons sit above the conversation.

Check an app

For web projects, start your development server from the Web panel. On Windows and Linux, open the local URL in your browser. A static site can use an index.html file and Python 3. To let the agent interact with a local page, install Node.js and Chrome, Chromium, Edge or Brave.

For Android, install the Android SDK and create an emulator. For iOS, use Xcode on macOS with a Simulator runtime. Select a device in the Mobile panel to run the app and read its logs.

UMIDE Classic guide

The following steps apply to the original Lapce-based mobile IDE.

Install

Download UMIDE Classic from the Classic download page and open your React Native or Flutter project. UMIDE auto-detects the stack and shows it in the status bar.

For the embedded iOS Simulator on macOS (no Simulator.app window), install the companion:

brew install idb-companion

You’ll also want Xcode (iOS) and the Android SDK/emulator for the platforms you target. UMIDE resolves adb / emulator from ANDROID_HOME or the per-OS default.

Run on device

The top bar has a prominent ▶ Run button. On macOS you pick ▶ Android or ▶ iOS. On Windows, ▶ Run launches the Android app. The build and launch output appears in a live terminal tab.

Embedded emulators

Open the Emulators panel (right dock), start a device, and it renders live inside the IDE. Tap, swipe, type, and press hardware buttons — no separate emulator window. On macOS the iOS Simulator runs headless via idb_companion.

Device logs

The Device Logs panel (bottom dock) streams Android logcat and the iOS unified log live — severity-coloured, tailing, one click to clear. No Android Studio or Xcode just to read logs.

AI assistant

The assistant lives in the left sidebar (the ✨ tab). Connect your AI provider with an API key (Claude or OpenAI). It reads your code, proposes edits with per-action approval, runs commands, and can screenshot and drive the running device to verify its own changes.