Getting started

LemonLime runs coding agents — Claude Code, Codex, OpenCode and any agent that speaks the Agent Client Protocol — on your own computer or in a cloud sandbox. Each task gets its own thread and its own git branch, so your checkout is never touched.

#Install the app

On macOS or Linux, run:

curl -fsSL lemonlime.dev/install | sh

It downloads the latest release from GitHub. On a Mac it copies LemonLime into Applications and opens it; on Linux it saves the app as ~/.local/bin/lemonlime. On Windows, download the installer from the releases page.

LemonLime is free and open source (MIT), and local agents need no account.

#Set it up

The first time you open LemonLime it walks you through four short steps. You can skip any of them and come back from Settings later.

1. Sign in to LemonLime Cloud, if you want agents that keep working after you close the laptop. Local threads don't need it.
2. Connect an agent. LemonLime finds Claude Code, Codex and OpenCode on your computer, shows their versions and whether you're signed in, and can install or update them for you. Agents use your own Claude, ChatGPT or API account; LemonLime never sees or bills your model usage.
3. Connect GitHub, so cloud threads can clone your private repositories and open pull requests.
4. Bring your work. LemonLime can import your past Claude Code, Codex and OpenCode chats so they show up as threads you can keep going.

#Your first thread

1. Click New thread, choose a project folder and an agent, and describe the task.
2. Pick This computer to run it here, or Cloud to run it in a sandbox.
3. The agent works in its own git worktree on a branch named agent/<thread-id>. Your branch and uncommitted changes stay exactly as they were.
4. On your computer the agent edits files freely but asks before running a command. You see the exact command and choose Allow or Don't allow.
5. Send more messages while it works: they wait in a queue, or use Send now to steer it straight away.
6. When it's done, review the changes and open a pull request.

#Cloud threads

A cloud thread runs in its own isolated machine. Start it, close the laptop, and check in later from the desktop app or the web dashboard at app.lemonlime.dev, including from your phone.

• Sign in to your agent once. The first cloud thread asks you to sign in to Claude or ChatGPT inside the sandbox (a code you paste or approve). LemonLime keeps it encrypted for your next threads. You can use an API key saved as a secret instead.
• Sizes. Small (1 CPU, 2 GB) by default, or large (2 CPUs, 4 GB) for heavier builds.
• Pauses itself. A sandbox pauses after 5 idle minutes and resumes the same conversation when you come back.
• Pushes every turn. The thread's branch is pushed to GitHub after each turn, so nothing is lost if you close everything.

See pricing for plans, and Cloud credits for how cloud time is counted.

#Beyond threads

• Skills teach agents how you like things done. Every thread gets LemonLime's skills for git hygiene, running tests first, opening pull requests and asking when blocked, plus any you add on the Skills page.
• Plugins bundle skills, slash commands, subagents and MCP servers. See Agent plugins.
• Automations run a prompt on a schedule in the cloud, like a nightly dependency bump, and collect the results in a review inbox.
• Side panel. Open terminals on your computer and a browser beside any page.

#Get help

• Questions and bugs: GitHub issues.
• Security problems: follow the security policy.
• Running everything yourself: Self-hosting.