Start here · Getting started
Your first workspace.
From a new account to a first reviewed change: start your plan, install the app, sign in, connect your coding agents and run a task.
Before you start
- A computer SwarmPane runs on: a Mac with macOS 13 or later (Apple silicon or Intel), a Windows 10 or 11 PC (x64), or a Linux PC (x64) with Ubuntu 22.04, Debian 12, Fedora 36 or a later release.
- At least one coding CLI you can sign in to, such as Claude Code or Codex. Each provider bills its own subscription and API usage; your SwarmPane plan doesn’t include them.
- A project folder you own and can safely edit. Keep it under Git, so every change is easy to review and undo.
Six steps, start to finish
- Create your SwarmPane account. It’s free, and it doesn’t start a plan.
- Start your plan: Starter, Pro or Ultra, monthly or yearly. Checkout takes a card, and your first plan starts with a 5-day trial for $1. Until the plan starts, My account shows only this step.
- Download SwarmPane for your computer and install it.
- Open SwarmPane, choose Sign in or create account, and approve the code in your browser.
- Connect your coding agents in Settings → Agents.
- Open Code, choose a project folder, and give an agent a first task.
Install the app
Downloads has the Mac disk image, the Windows installer and the Linux .deb; My account links the one for your computer once your plan starts. The Windows installer isn’t code-signed yet, so Windows shows a warning before it runs. The install guide has every step for each system, the AppImage for other Linux distributions, and how updates work.
Sign in from the app
The app signs in through your browser with a one-time code. A code works for 10 minutes. Approve only a code you started from your own app.
- Open SwarmPane and choose Sign in or create account. Your browser opens SwarmPane’s website with a code.
- Sign in with the account that has your plan, if you aren’t signed in already.
- Check that the code in the browser matches the one in the app, then choose Approve connection.
- Switch back to SwarmPane. It checks your plan and opens a few seconds later.
Connect your coding agents
Settings → Agents lists the coding CLIs SwarmPane found on your computer. For one that’s missing, Copy install copies its install command: read it, then run it in a terminal.
Then sign in to each CLI the way its provider asks, usually by running it once in a terminal. SwarmPane uses the sign-in each CLI already has.
To keep a work and a personal Claude Code or Codex account side by side, add them under Your AI accounts in Settings → Agents. Each gets its own sign-in, and you pick the account in each pane, conversation or workflow step.
Run a first task
- Open Code and choose your project folder. Its terminal panes and file tools work in that folder.
- Open a pane with the coding CLI you want, and pick the account if you have more than one.
- Ask for a small change with a clear finish line. For example: “Explain the failing test, make the smallest fix, and show the diff.”
- Review the changed files and the terminal output, and run your checks before you keep the result.