MarbloDownload, install & first launch
First, download and install the Marblo desktop app. macOS and Windows are supported, and the agent CLIs you need install automatically on first launch.
Get the app from the download page
On the download page, grab the latest build for your operating system (macOS or Windows). Apple Silicon and Intel Macs, and Windows 10/11, are supported.
Install and launch for the first time
Run the installer you downloaded. On macOS, open the .dmg and drag Marblo into your Applications folder; on Windows, follow the installer prompts.
On first launch you may see a macOS Gatekeeper or Windows SmartScreen warning. On macOS, choose 'Open Anyway' under System Settings > Privacy & Security; on Windows, choose 'More info > Run anyway'. The builds are properly signed.
Required CLIs & Marblo MCP install automatically
On first launch, Marblo automatically installs the required agent CLIs (Claude Code · Codex · Antigravity) and the Marblo MCP. There's no need to install anything from a Harness tab — just wait a moment for the install to finish.
There's nothing to install yourself. In the next step you only need to log in (authenticate) to each CLI, and you're ready to go.
Authenticate the CLIs (log in)
Because the required CLIs install automatically, your only setup task is to log in (authenticate) to each CLI.
Log in to Claude Code
Run the command below in a terminal and follow the prompt to sign in with your Anthropic account in the browser.
claude loginLog in to Codex
Log in to Codex the same way, authenticating with your OpenAI account.
codex loginAuthenticate Antigravity
Authenticate Antigravity as well. Follow the sign-in prompt that appears the first time you use it to log in with your account.
You only need to authenticate the CLIs you'll actually use. To run multiple agents at once, authenticate all of them.
Verify authentication
Once you're signed in, each CLI switches to an authenticated state. If the status doesn't update, try restarting the app.
Credentials are stored locally by each CLI — Marblo never stores your account password or API keys, and everything runs on your own machine.
Pick a folder — project auto-registers
Just pick the code folder you want to work in — with no confirmation step, the project registers automatically and the orchestrator starts alongside it.
Pick a folder = zero-click registration
Select a local folder and Marblo registers it as a project right away. There's no 'Do you want to register?' confirmation click — picking the folder is all it takes. You can switch between registered projects from the sidebar.
A git repository is recommended. Marblo runs multiple agents safely in parallel using isolated git worktrees and tracks changes as diffs.
The orchestrator auto-starts
Once the project is registered, the orchestrator starts automatically and opens a dedicated terminal session. It analyzes your request, breaks it into tickets, and spawns agents with an assigned role (frontend, backend, etc.) and model (Claude, GPT/Codex, Antigravity).
We recommend running a small task with a single agent first to get comfortable with the flow, then scaling up to multiple agents at once.
Run your first mission / flow
Now it's time to give real work. Hand your first mission to the orchestrator.
Write a mission
Describe the feature you want to build or the bug you want to fix in plain language to the orchestrator. It breaks this down into tickets on the kanban board.
Run & track progress
While agents work through tickets in parallel, you can track progress in real time on the kanban board. Each agent's terminal output is available in its own tab.
The review gate
Finished tickets move to the REVIEW state. A human confirms the changes and approves them before they're merged.
Always review the diff before merging an agent's changes. Marblo places a human REVIEW gate before merge so unintended changes don't land automatically.
Billing & plans
Marblo is free to start, and you can upgrade to Pro when you need more.
Explore the plans
The Free plan gives you the core features at no cost. Pro is a monthly subscription with additional features. See the pricing page for the differences.
Usage fees for the agent CLIs (Claude, Codex, Antigravity) are billed separately to each provider account and are independent of your Marblo subscription.
Manage your subscription
After signing in, view and manage your subscription status and billing history from your account.
FAQ & help
If you get stuck, the resources below can help.
Learn more
Find answers to common questions in the FAQ, and report a bug if something goes wrong. Take a look at the Founder program too.