Getting Started

Getting Started

Prerequisites

• macOS, Node.js 18+ and npm.
• For backends you'll use via App login: install and log in to the CLIs
  • claude (Claude Code)
  • codex (OpenAI Codex)
• For backends you'll use via API key: an Anthropic / OpenAI / DeepSeek key (entered in-app, no CLI needed).

You don't need everything — e.g. you can run entirely on API keys, or entirely on App login.

Run from source

git clone https://github.com/zoyluoblue/AgentStudio.git
cd AgentStudio/studio
npm install
npm run dev        # launch in development

Useful scripts (run inside studio/):

Command	What it does
npm run dev	Launch the app in development (hot reload)
npm run typecheck	TypeScript check (tsc --noEmit)
npm run build	Build main/preload/renderer with electron-vite
npm run dist	Build a double-clickable macOS .dmg → studio/release/

The packaged app is ad-hoc signed so a self-built Apple-Silicon build can launch. To distribute without the "unidentified developer" prompt, set a Developer ID identity in studio/electron-builder.yml and add notarization.

First run

1. Pick a project folder (top bar → Select project). Everything the agents do happens inside this folder.
2. Connect a backend in each lane — choose App login or API Key per lane (see Backends and Connection).
3. Choose a mode — Solo or Dual (see Concepts).
4. Describe what you want and press Enter.

That's it — no terminal needed after this point.