$100 off Fall Sale
Master the Fundamentals. Build Better With AI.
Get Discount Now →

Introducing Solo

Solo is one of my favorite new tools. I heard about it recently from its creator, Aaron Francis, while at a conference he was emceeing.

Solo’s website describes it as a Meta-harness for coding agents, but I don’t think that does the project justice. To me, Solo is a control panel for whatever project I’m working on, with deep AI integration (naturally). It’s home to any terminals I might need, with common commands preloaded into dedicated slots in Solo, with the option to auto-start. And again, AI is deeply integrated: you can launch agents, and what’s especially neat is that Solo provides its own MCP server that gives your agents access to your tasks and terminals to help debug problems you’re having.

Let’s take a look!

Solo

I won’t walk you through installation or adding a project. It’ll make some best guesses on which commands you’ll likely want. Tweak as desired (you can always adjust later) and create it.

Here’s what mine looks like for a fitness tracking application I’ve been messing with.

Development environment window showing the output of a local server setup for a fitness tracker project, including commands and instructions for accessing the server.

This is a TanStack Start web application, and as you can see, I’ve got two commands (basically a terminal embedded in Solo) running: my dev web server and Postgres via Docker.

As you hover over those commands, you’d see buttons to stop, start, or restart any of these commands. Naturally, you can click any of these commands and see that terminal’s output in the main Solo window. In the image above, you can see my dev server.

And obviously you can edit these commands anytime.

Screenshot of a development server configuration in a terminal interface, displaying settings such as the command 'npm run dev', working directory, auto-start options, and notification levels.

Starting Agents

So far, all I’ve shown is an app that manages multiple terminals in one convenient place, with common commands pre-set.

But it’s 2026, so obviously you want to see the AI integration. Naturally you can start agents in Solo; there’s even a dedicated section for it, which you can see in the image above. There’s no shortage of shortcuts and UI commands for this, but just hit Command-T and type “agent”

A screenshot of a software interface displaying options for creating new agents, including 'New Claude agent' and 'New Codex agent' with variations such as 'with custom flags'.

Don’t worry, Solo supports virtually any agent you’ve ever heard of; only Claude and Codex show up here because that’s all I bothered to set up.

Once you start an agent, it’s living as normal right inside Solo, just like you’re used to.

Screenshot of Claude Code interface v2.1.220 displaying a welcome message, tips for getting started, and recent updates.

Nothing changes for you as the user.

Solo’s Built-in MCP

I moved kind of fast above because I wanted to get to the more interesting AI pieces. I mentioned earlier that Solo has a built-in MCP server that lets your agents inspect (among other things) your other commands and their outputs to help debug problems.

Let’s try it out. I’ll stop my database process.

Screenshot of a code management interface showing project details for 'fitness-tracker', including sections for to-dos, agents, terminals, commands, and scratchpads.

Obviously nothing will work now.

Code snippet displaying an error message related to API session management, indicating an internal server error with the status code 500.

As a control, before I touch Solo’s MCP, let’s make sure this isn’t something a vanilla Claude agent could easily debug. When I ask it why I have errors in my dev server, it starts taking steps to start the dev server and reproduce.

Screenshot of a terminal displaying a request for help with debugging dev server errors and commands to check dev scripts in package.json.

I’d prefer it to just look at my existing output, along with neighboring commands.

Enabling MCP

The MCP section in Solo has a dirt-simple way to enable it for whatever agent you use. It gives you a bash command, or if that’s too much effort, a nice fat “Run” button that executes that command for you.

Terminal interface displaying a command to add a user entry in Claude Code, with instructions to check for existing entries and a button to run the command.

Find your harness of choice and smash that Run button, and it should show as installed.

Screenshot of terminal commands for Claude Code installation and setup, displaying commands to add, check, and remove an MCP entry.

Using Solo’s MCP

When we try to debug the same problem with the same prompt, unfortunately nothing really changes.

A programmer seeks help with debugging errors on a development server, displaying text in a code editor revealing package.json reading and npm run commands.

If you want to engage Solo’s MCP, you need to be a bit more specific in your prompt

Debugging report for a dev server process showing PostgreSQL is down, causing connection errors in a database application.

Adding a Skill

Like any software engineer, I tend to be lazy and would prefer to not have to manually tell it “hey, use Solo’s MCP to blah blah” every time I want it to. A skill is a nice way to wrap that bit of functionality up.

At the time of writing, Skills have sort of gotten a bad name, with devs dumping way too many of them in their repo, flooding context windows, potentially affecting skill selection quality, etc. But a skill that can only be manually invoked can avoid those issues and essentially serve as a subroutine for wrapping common functionality (like any function we’re used to writing).

Here’s the skill I whipped up:

---
name: solo-debug
description: Debug this application using Solo MCP
disable-model-invocation: true
---

# Solo Debug

Use the Solo MCP tools to inspect the processes already running
for this project.

1. Inspect recent output and errors.
2. Use those process outputs to help diagnose what's being asked.
3. Do not start new processes unless necessary.Code language: Markdown (markdown)

Note this line:

disable-model-invocation: trueCode language: YAML (yaml)

That prevents models from invoking it on their own.

I put that in .claude/skills/solo-debug/SKILL.md and with that, I can now just do /solo-debug and type my original prompt

A terminal output showing debugging information for a development server, highlighting a PostgreSQL database connection issue and instructions to restart the Postgres container.

There’s So Much More

I’m about to wrap this post up, but if you’re feeling underwhelmed with Solo, I promise I’m barely scratching the surface. Solo also supports scratchpads and to-dos, which, of course, can integrate with your agents. And there are entire AI orchestration workflows. They even have guides on building better daily workflows.

Wrapping Up

Solo is a superb tool for managing multiple processes and agents and connecting everything seamlessly. The process management alone is nice, but the built-in MCP support for improved debugging really makes this tool a favorite of mine. And that is before we’ve even scratched the surface of the deeper AI workflows it supports.

Interested in TanStack?

Leave a Reply

Your email address will not be published. Required fields are marked *

$966,000

Master.dev donates to open source projects through thanks.dev and Open Collective, as well as donates to non-profits like The Last Mile, Annie Canons, and Vets Who Code.