How it works
Orchestration
Pricing
Compare
Agents
Blog
Docs
Login

Product docs for Solo's desktop workflow: setup, projects, commands, agents, notifications, and troubleshooting.

Getting started

Installation and system requirements First launch The demo project Interface overview Understanding projects, processes, and sections

Projects

Creating and loading projects Command auto-detection solo.yml overview Project icons, names, and customization Project context menu Reordering projects and sections solo.yml change notifications

Workspaces

Workspaces overview Managing workspaces Multiple windows

Commands

Adding and removing commands Start, Stop, and Restart Auto-start Auto-restart File-watch Auto-restart Status Indicators Renaming commands Reordering Commands Lesser-used Commands Orphaned Processes Trust and Security

Agents

What are agents?Setting up agent tools Adding custom agents Agent installation health Launching agents in a project Stopping and resuming agents Auto-summarization Agent idle detection Closing agents

MCP tools

MCP tools overview Project MCP tools Workspace MCP tools Services MCP tools Process MCP tools Bulk MCP tools Output MCP tools Agent and terminal MCP tools Coordination MCP tools Setup and support MCP tools Scratchpad MCP tools Todo MCP tools Prompt template MCP tools Timer MCP tools Key-value MCP tools MCP prompts and resources

Workflows

Daily operating patterns Run a Laravel dev stack Check automatic command restarts Build, review, and land one change Debug a live application with an agent Run an independent review panel Hand off long-running work between agents Scratchpads and todos as agent memory Agents spawning agents Agent orchestration workflow

Todos

Using todos Todo agent tools

Scratchpads

Using scratchpads Scratchpad agent tools

Prompt templates

Prompt template scopes and library Creating and editing templates Placeholders Using templates

Terminal

Terminal basics Terminal control bar Terminal context pins Terminal keyboard input Terminal mouse ownership Terminal focus behavior Searching terminal output Terminal reattach behavior Follow output and jumping to bottom Terminal session persistence Terminal right-click menu OSC, links, and Kitty keyboard protocol Program status protocol (OSC 7501)

Sidebar

Understanding sections Filtering the sidebar Process favorites CPU and memory stats Collapsing and expanding sections Reordering sections Section splash screens

Activity

Activity monitor

Keyboard shortcuts

Default keyboard shortcuts reference Sidebar keyboard navigation Switching projects and commands Customizing keyboard shortcuts

Notifications

macOS notification permissions In-app toast notifications Notification indicators Auto-restart notifications Bell sounds Triggering notifications from scripts

Environment

Shell environment Execution profiles Version managers

Integrations

MCP server integration HTTP API Deep links

CLI

Solo CLI overview Projects and processes from the CLI Todos and scratchpads from the CLI JSON output and scripting

Settings

Settings overview Tools: editors, terminals, and browsers Sidebar settings

Appearance

Themes Terminal font settings Interface font and scale

Updates

Installing updates Restarting safely for updates

Account

Free tier Activating a license Team licenses Moving a license to another machine License errors

Troubleshooting

Commands can't find tools (PATH issues)Notification troubleshooting Resetting settings and state Reporting issues

Command palette

Using the command palette Quick jump Focus jump Actions palette Context actions New tab picker Prompt template picker Native app menus

Useful links

Download Solo Help Agent workspace Compare Solo Changelog

Docs
Settings

Settings

Settings let you make Solo match the tools and layout you already use. This section covers app preferences, agent tools, editors, terminals, and the controls that shape what appears in the sidebar.

Settings overview

Solo's settings control app appearance, notifications, hotkeys, the sidebar and workspaces, terminal behavior, agents, optional features such as Todos and Scratchpads, MCP and the…

Tools: editors, terminals, and browsers

When you open a project in an external editor or terminal, or open a local service URL in a browser, Solo needs to know which app to launch. The Settings > Terminal > Tools page is…

Sidebar settings

The Sidebar settings page controls how the sidebar looks and what it displays. Open Settings (by default, Cmd+, on macOS or Ctrl+, on Windows and Linux; the shortcut can be changed…

Are you an agent? Read this doc via API: /api/v1/docs/settings

Solo is the programmable meta-harness for coding agents that runs every CLI harness beside your dev stack and gives agents shared processes, scratchpads, todos, and control through MCP, HTTP, or the Solo CLI.

Built by Aaron Francis, dad to two sets of twins, creator of faster.dev, and creator of Database School. He built Solo after running Claude Code alongside his dev stack and juggling nine terminal tabs.

Links

How it works Orchestration Pricing Compare Agents Blog Docs Login Download Help Changelog License the terminal

Legal

Privacy Policy Terms of Service

Compare

See how Solo’s programmable meta-harness fits around the editors and coding harnesses you already use without replacing them.

Comparisons

All comparisons Solo terminal vs xterm.js Solo vs Cursor Solo vs Devin Desktop Solo vs Warp

Alternatives

All alternatives Cursor alternatives Warp alternatives VS Code Alternative Claude Code alternatives

Solo © 2026 Try Hard Studios, LLCWebsite designed by Quick14