Quick Start
Get Lemonade running with multiple AI agents in under five minutes.
Installation
Windows
Lemonade ships as a signed NSIS installer. Windows Defender may show a SmartScreen prompt on first run — click More info → Run anyway.
Download for WindowsmacOS
Download the universal DMG. Mount it, drag Lemonade to Applications, then open it. On first launch macOS will ask to verify — go to System Settings → Privacy & Security → Open Anyway.
Download for macOSActivation
Lemonade uses a one-time license key tied to your purchase email. You can activate on up to two machines.
Entering your key
On first launch the welcome screen will prompt you. Paste your key and click Activate. The app will verify online and unlock immediately.
Offline grace period
Once activated, Lemonade caches your license locally. If you're offline, the app will run for up to 7 days without re-verifying — no internet required during that window.
Lost your key?
Check the original purchase confirmation email. For Gumroad purchases it's in the receipt. For LemonSqueezy you can also log into your account and retrieve it from your purchase history.
Agents
Lemonade supports any AI coding CLI that runs in a terminal. Built-in presets are available for the most popular tools.
Supported agents
Claude Code
Gemini CLI
Codex CLI
OpenCode
Aider
Goose
Amp
Cursor
Continue
Cline
Kilo Code
MiniMax
Custom agent configuration
Any agent not in the preset list can be added as a custom command. In the agent picker, choose Custom and type any shell command — Lemonade will run it in a new terminal cell.
Startup delays
Each agent preset includes a configurable startup delay so agents don't race each other for terminal focus on launch. You can adjust this in Settings → Agents.
Dangerous mode
Some agents (like Claude Code) support a --dangerously-skip-permissions flag that bypasses all confirmation prompts. Enable per-agent or globally in Settings → Agents. Use with caution in production codebases.
Workspaces
Workspaces let you run separate agent grids for different projects or contexts, all in the same Lemonade window.
Creating & switching
Click + in the tab bar to create a new workspace. Each workspace has its own grid, agents, and working directory. Switch between them instantly without killing any sessions.
Pinning workspaces
Right-click a workspace tab and select Pin. Pinned workspaces are restored automatically on next launch with their original agent configuration.
Renaming
Double-click any workspace tab to rename it inline. Names persist across sessions for pinned workspaces.
Attention detection
When a background workspace has an agent waiting for a yes/no response, its tab pulses amber. Switch to it to respond without losing your place in another workspace.
Grid View
The grid is the core of Lemonade — a tiled terminal layout that puts multiple agents side by side.
Layout sizes
| Agents | Layout |
|---|---|
| 1 | Full screen |
| 2 | Side by side |
| 3–4 | 2×2 grid |
| 5–6 | 2×3 grid |
| 7–8 | 2×4 grid |
Adding & closing agents
Click + Agent in the status bar to add a new agent to the current workspace (up to 8). Close any agent by clicking the × on its terminal header or pressing Ctrl+W with that terminal focused.
Broadcasting
Broadcast mode sends your keystrokes to all terminals simultaneously. Press Ctrl+Shift+B to toggle it. A yellow indicator appears in the status bar when active. Useful for running the same command across all agents at once.
Studio Mode
Studio is an infinite pan/zoom canvas for orchestrating agents alongside your notes, media, browser windows, and task lists — all in one freeform workspace.
Node types
- Agent — a standalone terminal running a single AI agent
- Group — a multi-agent grid (1–8 agents) inside a single container; useful for running parallel agents on the same sub-task
- Note — a color-coded sticky note (7 colors) for context, links, or instructions; double-click to edit
- Task list — a lightweight checklist you can tick off as agents complete work
- Media — images, video, or audio dropped directly onto the canvas; images and video lock aspect ratio automatically
- Browser — an embedded web view with an editable address bar; useful for docs, dashboards, or design references alongside your agents
Adding nodes
Right-click anywhere on the canvas to open the node menu. For agents and groups you'll get a submenu to pick the agent preset. You can also drag image, video, audio, or PDF files directly from your file system onto the canvas — media files become Media nodes, PDFs open in a Browser node.
Navigation
Scroll to zoom (Ctrl+scroll), or use Ctrl+Plus / Ctrl+Minus. Pan with middle-mouse drag or Space+drag. Press Ctrl+0 or use the reset button in the bottom-right corner to return to the default view. Zoom range is 25%–300%.
Moving & resizing
Drag any node header to reposition it. Drag the resize handles on the corners and edges to resize. Double-click a node header to pin it in place — pinned nodes cannot be moved or resized. Right-mouse drag on the canvas draws a selection box; with multiple nodes selected, dragging one moves them all together.
Canvas background
Choose between a plain canvas, a dot grid, or a line grid in Settings. The pattern scales with your zoom level.
State & persistence
Studio layout is saved per workspace. Switching workspaces or reopening Lemonade will restore your nodes, viewport position, and zoom level exactly as you left them. Pinned workspaces also preserve Studio state across restarts.
Keyboard Shortcuts
Global
Terminal
Studio
Settings
Open with Ctrl+, or from the menu. Settings are persisted across sessions.
Terminal
- Font size — terminal font size in pixels (default 14)
- Font family — monospace font used in terminals
- Cursor style — block, underline, or bar
- Cursor blink — toggle cursor blink animation
- Line height — terminal line spacing multiplier
- Terminal opacity — background opacity for terminals
Appearance
- Theme — choose from 6 themes (3 dark, 3 light)
- App font size — UI font size separate from terminal font
- Show status bar — toggle the bottom status bar
Agents
- Hidden agents — hide preset agents you never use from the picker
- Default counts — pre-fill how many of each agent to launch
- Default custom commands — saved custom agent commands
- Dangerous mode (all) — globally enable --dangerously-skip-permissions
General
- Auto-update — check for updates automatically on launch
- Show welcome on startup — show the welcome screen each launch
- Confirm before closing workspace — prompt before closing tabs with active agents
- Freeform resize — allow dragging terminal borders to resize cells
Troubleshooting
Agent won't start
Make sure the agent CLI is installed and accessible on your PATH. Open a regular terminal and run the agent command manually to confirm it works. If you're using a custom command, verify the full path.
License activation fails
Check your internet connection — activation requires a one-time online verification. If the error persists, ensure your license key is copied without leading or trailing spaces. Contact [email protected] with your order number.
Terminal appears blank or glitched
Lemonade uses WebGL for terminal rendering. If you're on a machine with a degraded GPU driver, it will fall back to canvas rendering automatically. Try restarting the app. If the issue persists, disable hardware acceleration in your OS display settings.
App won't update
Go to Settings → General and click Check for Updates manually. If the update downloads but fails to install, try downloading the latest installer directly from the Download page.
High memory usage
Each terminal cell runs a full PTY session. Running 8 agents simultaneously plus the agents' own memory footprint can be significant. Close agent tabs you're not actively using, or reduce the number of simultaneous agents in Settings → Agents → Default counts.