Solo
  • How it works
  • Orchestration
  • Pricing
  • Compare
  • Agents
  • Blog
  • Docs
  • Login
Download Solo download
Docs home

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

Getting started

Installation and system requirementsFirst launchThe demo projectInterface overviewUnderstanding projects, processes, and sections

Projects

Creating and loading projectsCommand auto-detectionsolo.yml overviewProject icons, names, and customizationProject context menuReordering projects and sectionssolo.yml change notifications

Workspaces

Workspaces overviewManaging workspacesMultiple windows

Commands

Adding and removing commandsStart, Stop, and RestartAuto-startAuto-restartFile-watch Auto-restartStatus IndicatorsRenaming commandsReordering CommandsLesser-used CommandsOrphaned ProcessesTrust and Security

Agents

What are agents?Setting up agent toolsAdding custom agentsAgent installation healthLaunching agents in a projectStopping and resuming agentsAuto-summarizationAgent idle detectionClosing agents

MCP tools

MCP tools overviewProject MCP toolsWorkspace MCP toolsServices MCP toolsProcess MCP toolsBulk MCP toolsOutput MCP toolsAgent and terminal MCP toolsCoordination MCP toolsSetup and support MCP toolsScratchpad MCP toolsTodo MCP toolsPrompt template MCP toolsTimer MCP toolsKey-value MCP toolsMCP prompts and resources

Workflows

Daily operating patternsBuild, review, and land one changeDebug a live application with an agentRun an independent review panelHand off long-running work between agentsScratchpads and todos as agent memoryAgents spawning agentsAgent orchestration workflow

Todos

Using todosTodo agent tools

Scratchpads

Using scratchpadsScratchpad agent tools

Prompt templates

Prompt templatesCreating and editing templatesPlaceholdersUsing templates

Terminal

Terminal basicsTerminal control barTerminal context pinsTerminal keyboard inputTerminal mouse ownershipTerminal focus behaviorSearching terminal outputTerminal reattach behaviorFollow output and jumping to bottomTerminal session persistenceTerminal right-click menuOSC, links, and Kitty keyboard protocol

Sidebar

Understanding sectionsFiltering the sidebarProcess favoritesCPU and memory statsCollapsing and expanding sectionsReordering sectionsSection splash screens

Activity

Activity monitor

Keyboard shortcuts

Default keyboard shortcuts referenceSidebar keyboard navigationSwitching projects and commandsCustomizing keyboard shortcuts

Notifications

macOS notification permissionsIn-app toast notificationsNotification indicatorsAuto-restart notificationsBell soundsTriggering notifications from scripts

Environment

Shell environmentExecution profilesVersion managers

Integrations

MCP server integrationHTTP APIDeep links

CLI

Solo CLI overviewProjects and processes from the CLITodos and scratchpads from the CLIJSON output and scripting

Settings

Settings overviewTools: editors, terminals, and browsersSidebar settings

Appearance

ThemesTerminal font settingsInterface font and scale

Updates

Installing updatesRestarting safely for updates

Account

Free tierActivating a licenseTeam licensesMoving a license to another machineLicense errors

Troubleshooting

Commands can't find tools (PATH issues)Notification troubleshootingResetting settings and stateReporting issues

Command palette

Using the command paletteQuick jumpFocus jumpActions paletteContext actionsNew tab pickerPrompt template pickerNative app menus

Useful links

Download Solo Help Agent workspace Compare Solo Changelog
  1. Docs
  2. 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 give you control over app appearance, terminal behavior, sidebar behavior, workspaces, notes and todos, hotkeys, agents, tools, MCP, notifications, and your account…
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 Tools tab is where you configure th…
Sidebar settings
The sidebar settings tab 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

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 worksOrchestrationPricingCompareAgentsBlogDocsLoginDownloadHelpChangelog
Legal
Privacy PolicyTerms 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 comparisonsSolo vs CursorSolo vs Devin DesktopSolo vs WarpSolo vs Zed
Alternatives
All alternativesCursor AlternativeWarp AlternativeVS Code AlternativeClaude Code Alternative
Solo © 2026 Try Hard Studios, LLCWebsite designed by Quick14
Solo terminal workspace preview