checkA layer above the harnesses you already use

The meta-harness for coding agents

A programmable control plane where Claude, Codex, OpenCode, Pi, custom agents, and your dev stack work together.

Ask Codex to spawn Claude and OpenCode, split the work, share context, and bring the result back — without leaving the workspace.

Free for four projects on macOS and Windows.

Start with what you know

Grow into the superpowers at your own pace.

Start with a calm, native terminal workspace instead of changing the way you work on day one. Add the parts of your dev stack you use every day, then let agents work in the same environment whenever the job calls for them.

Day one

A terminal that feels familiar

Open a project, run a shell, and keep moving in a familiar terminal with vertical tabs and better ergonomics.

As you settle in

Your stack becomes a workspace

Save the commands the project needs, organize them into workspaces, and stop rebuilding the same terminal layout every morning.

When you are ready

Everything becomes programmable

Agents can spawn, control, and orchestrate those same terminals, commands, and shared context through MCP, HTTP, or the Solo CLI.

Your whole application

Building an application takes more than a chat.

Your agents need the same running system you do: the dev server, logs, queue workers, schedulers, webhook forwarders, tunnels, test watchers, and everything else that turns source code into an application.

Define that system once in solo.yml so humans and agents can share its processes instead of starting another copy of npm run dev each time.

Your agents debug the application that is actually running, not the one they imagine.

solo.yml
shared project manifest

Dev server

npm run dev
shared & running

Application logs

tail -f storage/logs/app.log
shared & running

Queue

php artisan queue:work
shared & running

Stripe webhooks

stripe listen --forward-to …
ready · 04

Cloudflare tunnel

cloudflared tunnel run
ready · 05
Run one stack without duplicate ports or mystery processes.

“When I begin work my ritual is now to open Solo. Solo starts all my local dev environments, meaning I can jump between Cursor windows without needing to start everything manually again. It basically replaced dev env setup within the IDE, which just gives me more room to work.

Jesse Hanley · @jessethanley
Works with any stack Auto-detects processes for:
Laravel
Node.js
Next.js
Nuxt
Rust
Django
Ruby
Go
.NET
Elixir
Svelte
Spring
Remix
Astro
FastAPI
Flask
Laravel
Node.js
Next.js
Nuxt
Rust
Django
Ruby
Go
.NET
Elixir
Svelte
Spring
Remix
Astro
FastAPI
Flask
Laravel
Node.js
Next.js
Nuxt
Rust
Django
Ruby
Go
.NET
Elixir
Svelte
Spring
Remix
Astro
FastAPI
Flask
Laravel
Node.js
Next.js
Nuxt
Rust
Django
Ruby
Go
.NET
Elixir
Svelte
Spring
Remix
Astro
FastAPI
Flask

Bring every harness

The tools you chose, not worse replacements for them.

Solo wraps the actual CLI binaries already installed on your machine, leaving each tool’s models, authentication, permissions, configuration, and release cadence intact. You can add any CLI agent you want without lock-in or a compatibility wait.

Claude Code

Claude Code

Codex

Codex

OpenCode

OpenCode

Pi

Pi

Gemini CLI

Gemini CLI

Custom agent

No compatibility waiting room

When a harness ships a new feature or a provider releases a new model, you get it directly through that harness without waiting for Solo to rebuild or approve it.

Your binaries, credentials, and subscriptions stay yours.

The missing layer

A room full of useful agents needs a system.

Solo sits above the coding harnesses you already use, allowing a lead agent to bring in specialists from other harnesses, give them durable context, divide the work, wait for them, and collect the result.

The terminals stay real and visible while your agents orchestrate through a shared, programmable workspace instead of a mysterious model loop.

A concrete example

Ask Codex to spawn Claude and OpenCode, assign each one part of the work, then synthesize what they return.

“I'm starting to see the power of SoloTerm by using Codex as an orchestrator and Claude as a coder. Self-review / second opinion. Continue after rate limit. Auto-steering.”

Eser Deniz · @SRWieZ

The meta-harness

Solo gives every harness the same workspace and primitives

Harnesses

Claude Code · Codex · OpenCode · Pi · custom

Models

Claude · GPT · Gemini · whatever comes next

Orchestration primitives

Small building blocks for serious workflows.

Instead of prescribing one giant automation framework, Solo gives agents a focused set of durable primitives to compose around the work in front of them.

01

Scratchpads

Scratchpads keep durable markdown context beyond the chat, with MCP, HTTP, and CLI access for agents and a full editor for humans.

02

Built-in todos

Turn a plan into structured work by breaking tasks down, connecting dependencies, and letting agents set blockers across the graph through MCP or the UI.

03

Prompt templates

Save favorite prompts in an agent-independent library, like skills built into Solo, then drop them into any terminal with a keystroke.

04

Control terminals

Agents can spawn new terminals and control them as real terminals: read the PTY bytes, send input, and monitor progress — without you copying scrollback between tabs.

05

Agent spawning

One agent can spawn another, even from a different lab, so Codex can hand work to Claude or Claude to Gemini, wait for completion, and harvest the result.

“No more retyping the orchestration: plan → scratchpad → todos → monitor sub-agent team (timers) → cleanup. Feels good.”

Jeremy Nikolic · @jeremy__nikolic

“The Solo MCP server is genius. No more writing todos and plans to the project and accidentally committing them. Getting my workflows slowly shifted to using the Todos and Scratchpads.”

Tim Withers · @TheTimWithers

The agents you choose can use Solo’s shared room and building blocks however the work demands.

Start simple and grow into the meta-harness

Your terminal can become a control plane for your agents.

Download Solo

Fully programmable

Three ways into the same workspace.

MCP, HTTP, and CLI are equally capable control surfaces over the same local projects and processes, so you can choose whichever interface fits the agent, integration, script, or moment.

MCP
01

spawn_agent

project_id: 119

agent_tool_id: 7

name: "Claude — UI"

For coding agents

Give MCP-capable agents direct tools for projects, processes, terminals, todos, scratchpads, spawning, waiting, and coordination.

HTTP
02

POST /api/projects/119/processes/spawn

{ "kind": "agent", "agentToolId": 7,

"name": "Claude — UI" }

For tools and integrations

Use the local bearer-token API to inspect and control the same Solo environment from launchers, utilities, or your own software.

CLI
03

solo processes spawn \

--project-id 119 --kind agent \

--agent-tool-id 7 \

--name "Claude — UI"

For scripts and terminals

Automate Solo from shell scripts, cron jobs, and CI: human-readable output for you, structured JSON for your tools.

Written by my Codex agent

Solo gives the work somewhere to live.

A chat may be temporary, but the work usually isn’t.

With Solo, I can put the north star in a scratchpad, turn it into todos with real dependencies, bring in the right agents, and watch the actual processes they run. I can steer a worker when it needs direction or set a timer and return when something changes.

Without that layer, you end up being the memory, the message bus, and the person who keeps asking, “Is it done yet?” Solo keeps the context with the project so the agents can coordinate around it.

Before writing this, I looked back at every available conversation and found 1,302 where I used Solo, totaling 72,556 MCP calls. Most of those calls were gloriously boring: read the output, check the status, send some input, update the plan, and come back later, which is exactly why I like it.

The impressive part is how Solo keeps the job coherent after I start another agent.

C
Codex

OpenAI coding agent

From the people building with it

A technical workflow should make the day feel easier.

Solo should feel powerful without adding more work, and these customers can best explain what changed in their own words.

Customer story 01

“Went back and forth with Claude to make a plan on a pretty gnarly problem. Had Solo spawn a Codex review it. Threw it in a Solo scratchpad. Had Solo split it into independent todos and spawn agents to implement. It's running 4 agents and waiting for them. This is the stuff.

Jason Beggs
Jason Beggs

@jasonlbeggs

Customer story 02

“It's a meta-harness with its own MCP that allows orchestrating agents that share context, tools, and more. It also lets you run the entire environment from a single terminal. I recommend trying it out!”

Mauro Casas
Mauro Casas

@maurohouseless

Customer story 03

“Just tried soloterm.com, don't know why I waited so long. Just logged on to twitter to tell you that it's good and it feels like the missing piece I needed for my workflow.

Cameron Gose
Cameron Gose

@cgose001

Customer story 04

“Solo is busy creating to-dos, spinning up agents, creating sandboxes and running my dev stack. All while I'm sitting back watching YouTube!

Duncan McClean
Duncan McClean

@_duncanmcclean

Customer story 05

Scratchpads in Solo are a hidden gem. Giving agents a simple, shared place to share state and provide feedback for the human is fantastic.”

Scott Watermasysk
Scott Watermasysk

@scottw

Customer story 06

“Just set an agent in Solo to pick back up where it left off when usage resets. Thanks for a great piece of software.”

Huw Fulcher
Huw Fulcher

@huwful

Customer story 07

“Just picked up Solo Pro! One of the best purchases I've made this year.

Braydon Coyer
Braydon Coyer

@BraydonCoyer

Local by design

Keep control of the tools you already use.

Solo is infrastructure around the tools you chose rather than a toll booth in front of them, so you can keep the harnesses, credentials, models, subscriptions, and local environment you already trust.

The actual binaries

Solo launches the Claude, Codex, OpenCode, Pi, and other CLI tools installed on your system rather than imitating them.

Your existing credentials

Each harness keeps using its own account and authentication, so your API keys and provider connection never pass through Solo.

No prompt proxy

Your agent conversations stay between the local harness and its provider instead of passing through a proprietary Solo model gateway.

Upstream on day one

When a harness adds a model or capability, it is available in Solo immediately without waiting for an integration release.

Bring your own agent

If a tool runs in a terminal, it has a place in Solo—even if it did not exist when this page was written.

CLICustom agents welcome

Built for the daily work

The control plane still has to be a great place to work.

Even with orchestration built in, Solo stays quiet, fast, and designed for developers who live at the keyboard.

A focused desktop app

Small and native

Built with Tauri and your system webview instead of bundling a browser-shaped development environment.

Shortcuts throughout

Keyboard driven

Move between projects, agents, terminals, and commands without making the mouse part of every decision.

Search, act, keep moving

Palettes everywhere

Reach actions and processes by intent instead of memorizing where every control lives in the interface.

A place for every project

Workspaces

Group the projects that belong together and keep separate areas of work legible without multiplying windows.

“Once you get soloterm's layout in mind, you just fly through with the shortcuts. Love it.”

Jeremy Nikolic · @jeremy__nikolic

“Clearly designed to be a power-user tool, but also simple enough that it does just exactly what you need. Really well designed.”

Mads Brodt · @madsbrodt

Four projects, free forever.

The Free plan includes every feature, so you only need Pro after you outgrow four projects.

FreeFull-featured, with no trial or expiration.$0forever
check
Up to 4 projects
check
Up to 20 processes total
check
All features included
check
MCP integration for AI agents
check
Native notifications
check
All future updates
Get started free 
ProUnlimited projects and processes.$99/year
check
Everything in Free
check
Unlimited projects
check
Unlimited processes
check
Priority email support
check
Activate on 3 devices
check
All future updates
Get pro licenseCancel anytime with a 30-day money-back guarantee.

Team seats

Centralized billing, simple claim-link distribution

Buy seats under one Stripe subscription, then share a claim link in Slack or email. Each claimant signs in or registers and receives a normal Solo Pro license. Optional auto-grow adds prorated seats automatically when the pool is full, so your team never hits a license wall.

Buy team seats

Seats 1–3

$99/seat/yr

Seats 4–10

$89/seat/yr

Seats 11–50

$79/seat/yr

Seats 51+

$69/seat/yr

Brackets apply per seat — a 10-seat team pays $99 each for seats 1–3 and $89 each for seats 4–10.

Frequently asked questions

How is this different from Warp?

Warp is a terminal-centered development platform with its own agent, editor, and cloud workflows. Solo is a local workspace and orchestration layer for the CLI agents and development tools you already use. It does not replace your terminal or editor. Read the full Solo vs Warp comparison.

Which coding agents can Solo run?

Solo has built-in support for Claude Code, Codex, Amp, Gemini CLI, OpenCode, GitHub Copilot CLI, Kimi CLI, and Antigravity. You can also add any interactive CLI agent, including Pi, as a custom tool. Solo launches the binaries already installed on your machine; it does not install or bundle them.

Does Solo use my agent accounts or API keys?

Solo does not broker model access or ask you for provider API keys. It launches each local CLI with the authentication and configuration you have already set up, so that tool's own account, billing, and provider terms still apply.

Can my agents coordinate with each other?

Yes. Through Solo's MCP tools, a lead agent can spawn agents in other harnesses, send follow-up work, read their output, and wait for them to finish. Shared todos, scratchpads, prompt templates, timers, locks, and key-value state keep coordination outside any one chat history.

How do I know what my agents are doing?

Solo shows whether an agent appears to be working, idle, waiting for permission, or blocked by an error. Optional auto-summaries add a one-line activity recap, while unread indicators, app badges, notifications, and the attention-jump shortcut point you to work that needs you. Detection is heuristic, so the terminal remains the source of truth.

Does Solo work with git worktrees?

Yes. When you link related checkouts in Solo, their worktrees or clones share todos, scratchpads, and prompt templates while their commands, terminals, and agents keep running in the correct checkout.

Can I script or automate Solo?

Yes. MCP gives coding agents orchestration tools, while the Solo CLI and bearer-token HTTP API expose the running app to scripts and integrations. The API listens only on localhost, and the desktop app must be running for anything that reads or changes app state.

Does Solo replace Docker?

No. Solo manages local processes rather than containers. It can run alongside Docker and supervise docker compose up like any other project command.

What platforms are supported?

The current beta supports macOS 11 (Big Sur) or newer and Windows 10 version 1809 or newer. Linux is planned but not available yet. See the download page for current builds and requirements.

Does Solo support WSL or remote servers?

On Windows, execution profiles can run a project's commands, terminals, and agents inside a selected WSL distribution. Solo does not currently provide remote-host or headless session management, so keep using SSH or a tool such as tmux for work that must survive on another machine.

What if Solo crashes?

Solo records managed process identities and automatically adopts matching processes when it launches again. If any unmatched processes remain, Solo shows them and lets you kill them or leave them running.

What happens when I close Solo?

Closing a workspace window does not quit Solo or stop its processes; reopen the workspace to return to them. Explicitly quitting Solo, or restarting it to apply an update, asks for confirmation and then stops running commands, agents, and terminals.

Are terminal output and agent sessions saved?

Process definitions persist, and Solo can detach from and reattach to a process while it is still running. Terminal output is retained for the current run, not as a permanent archive. Supported agent tools can resume saved conversations after their process stops.

How does the security/trust system work?

New or changed commands imported from solo.yml are blocked until you review and trust them. Trust is stored locally for that exact command configuration. Commands you create or save yourself are trusted immediately, and projects can opt into trusting future changes automatically.

What can I share in solo.yml, and what stays local?

Commit solo.yml to share project command definitions with your team. Personal commands can stay local, and you can move a command between local and shared storage from its settings. Terminals, agents, credentials, dependencies, and runtime state are never stored in solo.yml.

How do updates work?

Every plan includes future updates. Solo checks for updates automatically, but waits for you to approve a restart when processes are running. You can review each release in the changelog.

What's included in Free and Pro?

Free includes every feature and never expires, with limits of four projects and 20 managed processes in total. Pro is $99 per year and removes both limits.

How do Pro licensing and billing work?

One Pro license activates up to three devices. You can cancel at any time and keep Pro through the paid billing period, and new purchases include a 30-day money-back guarantee. If the license expires, Solo falls back to the Free limits rather than locking you out of the app.

Do you offer team licenses?

Yes. Team subscriptions provide centralized billing and a claim link for distributing seats. Each person who claims a seat receives a normal Solo Pro license, and billing managers can revoke seats or optionally let the pool grow up to a spending limit.

Does Solo work offline?

Solo's local process management works offline, although your agent CLI or other tools may still need a network connection. Free requires no license check. Pro checks in when Solo launches online and continues working offline for up to 14 days after a successful check-in.

Is there a dark mode?

Yes, you can choose light mode, dark mode, or a system option that follows your OS preference.

Does Solo collect any data or phone home?

Solo sends limited usage events to Aptabase; those events do not include project names, process names, terminal output, code, or other user text. It also makes normal requests for license validation, updates, and release notifications, and Sentry may receive technical error reports. Your agent CLIs communicate with their own providers, and optional auto-summaries send a compact terminal snapshot to the summarizer you choose. See the privacy policy.

Is this a fork of VS Code?

No. Solo is a Tauri desktop app, not an editor fork and not an Electron app. It uses the operating system's webview—WebKit on macOS and WebView2 on Windows—and focuses on agents, project commands, and terminal sessions.

How do I get support?

Email [email protected]

Built by

Built by Aaron Francis

Solo is built by Aaron Francis, creator of faster.dev and Database School, and VP of Marketing at Laravel. He built Solo after running Claude Code alongside his own dev stack and getting tired of juggling nine terminal tabs just to keep local agents, services, and project commands visible.

He is also a dad to two sets of twins, which tends to create a strong preference for software that reduces chaos instead of adding more of it. That is why Solo keeps showing up in these comparisons as the local workspace around your tools, not another editor or orchestrator trying to absorb the whole workflow.

Illustration of Aaron Francis holding two infant car seats

Give every coding agent the same room to work in.

Download Solo download

Free for four projects on macOS and Windows.

Start with a terminal and add the programmable meta-harness when you need to coordinate agents with your local development stack.

“I can't live without it.”

Jesse Hanley · @jessethanley