# Lemonade — Documentation

**Version:** 1.0.8 · **Platform:** Windows, macOS · **Docs:** https://getlemonade.dev/docs.html

---

## Quick Start

1. Download and install Lemonade for your platform
2. Paste your license key on first launch
3. Select a working directory (your project folder)
4. Add agents from the picker and hit **Launch**

> Tip: Start with 2–3 agents on the same task to compare approaches, then scale up.

---

## Installation

### Windows
Signed NSIS installer. Windows Defender may show a SmartScreen prompt — click **More info → Run anyway**.
- Requires: Windows 10+ (64-bit)
- No runtime required — fully self-contained

### macOS
Universal DMG (Apple Silicon + Intel). Drag to Applications. On first open: System Settings → Privacy & Security → Open Anyway.
- Requires: macOS 12 Monterey or later

Linux support is on the roadmap.

---

## Activation

Lemonade uses a one-time license key. Up to 3 activations per license.

- **First launch:** paste your key at the welcome screen, click Activate
- **Offline grace:** once activated, runs for 7 days without internet
- **Lost key:** check your purchase confirmation email, or your Gumroad/LemonSqueezy account

---

## Agents

Lemonade runs any CLI-based AI coding tool in a full PTY terminal.

**Built-in presets:** Claude Code, Gemini CLI, Codex CLI, OpenCode, Aider, Goose, Amp, Cursor, Continue, Cline, Kilo Code, MiniMax, Custom CLI

**Custom agents:** choose Custom in the agent picker and enter any shell command.

**Dangerous mode:** enables `--dangerously-skip-permissions` for agents that support it. Configurable per-agent or globally in Settings → Agents.

---

## Workspaces

Workspaces are independent agent grids — each with its own agents, working directory, and layout.

- **Create:** click `+` in the tab bar
- **Switch:** click any tab, or `Ctrl+1–9` — sessions stay live
- **Rename:** double-click any tab
- **Pin:** right-click → Pin; pinned workspaces restore on next launch
- **Attention:** background tabs pulse amber when an agent is waiting for a y/n response

---

## Grid View

The primary view. Up to 8 agents run side-by-side in a configurable terminal grid.

| Agents | Layout |
|--------|--------|
| 1 | Full screen |
| 2 | Side by side |
| 3–4 | 2×2 grid |
| 5–6 | 2×3 grid |
| 7–8 | 2×4 grid |

**Add agent:** `Ctrl+Shift+A` or click **+ Agent** in the status bar (max 8)

**Broadcast:** `Ctrl+Shift+B` — sends keystrokes to all terminals simultaneously. Yellow indicator appears when active.

---

## Studio Mode

An infinite pan/zoom canvas. Place agents, notes, media, and browser windows anywhere.

**Node types:**
- **Agent** — standalone terminal with any AI agent
- **Group** — up to 8 agents in one resizable container
- **Note** — color-coded sticky note (7 colors); double-click to edit
- **Task list** — interactive checklist
- **Media** — images, video, or audio; images/video lock aspect ratio on resize
- **Browser** — embedded web view with editable address bar

**Creating nodes:** right-click the canvas. Drop image/video/audio/PDF files directly onto the canvas.

**Navigation:** Ctrl+scroll to zoom (25%–300%), Space+drag or middle-click to pan, Ctrl+0 to reset view.

**Moving & resizing:** drag the header to move, drag corner/edge handles to resize. Double-click a header to pin (locks position and size).

**Multi-select:** right-mouse drag to draw a selection box; dragging one selected node moves all of them.

**Persistence:** Studio layout saves per workspace and restores on relaunch. Pinned workspaces preserve Studio state across restarts.

---

## Keyboard Shortcuts

### Global
| Action | Shortcut |
|--------|----------|
| New workspace | `Ctrl+T` |
| Close workspace | `Ctrl+W` |
| Switch workspace | `Ctrl+1–9` |
| Open settings | `Ctrl+,` |
| Toggle broadcast | `Ctrl+Shift+B` |
| Add agent | `Ctrl+Shift+A` |

### Terminal
| Action | Shortcut |
|--------|----------|
| Copy | `Ctrl+C` or `Ctrl+Shift+C` |
| Paste | `Ctrl+V` or `Ctrl+Shift+V` |
| Right-click paste | Right-click in terminal |
| Focus next terminal | `Ctrl+Tab` |
| Scroll up | `Shift+PageUp` |
| Scroll down | `Shift+PageDown` |

### Studio
| Action | Shortcut |
|--------|----------|
| Zoom | `Ctrl+Scroll` |
| Pan | `Space+Drag` |
| Add node | Right-click canvas |
| Reset view | `Ctrl+0` |

---

## Settings

Open with `Ctrl+,`. All settings persist across sessions.

**Terminal:** font size (default 14px), font family, cursor style (block/underline/bar), cursor blink, line height, terminal opacity

**Appearance:** theme (6 options — 3 dark, 3 light), app font size, show/hide status bar, Studio canvas background (plain/dots/grid)

**Agents:** hide unused presets, set default launch counts, save custom commands, enable dangerous mode globally or per-agent

**General:** auto-update on launch, show welcome screen on startup, confirm before closing workspaces, freeform terminal resize

---

## Troubleshooting

**Agent won't start** — confirm the CLI is installed and on your PATH by running it in a regular terminal first. For custom commands, verify the full path.

**License activation fails** — requires internet for first-time verification. Check for leading/trailing spaces in the key. Contact support@getlemonade.dev with your order number.

**Terminal appears blank or glitched** — Lemonade uses WebGL rendering with automatic canvas fallback. Restart the app. If it persists, try disabling GPU hardware acceleration in your OS display settings.

---

https://getlemonade.dev