Solo
  • Features
  • Workflow
  • Pricing
  • Compare
  • Agents
  • Docs
  • Login
Download free 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 toolsAgent installation healthLaunching agents in a projectAuto-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 patternsScratchpads 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 keyboard inputTerminal 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 and terminalsSidebar settings

Appearance

ThemesBundled VS Code themesImporting VS Code 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 paletteNew tab pickerContext actions (Cmd/Ctrl+P)Native app menus

Useful links

Download Solo Help Agent workspace Compare Solo Changelog
  1. Docs
  2. CLI

CLI

Control Solo from your shell with the solo command-line companion.

Solo CLI overview
The solo command is a companion CLI for the Solo desktop app. It talks to the running app over its local HTTP API, so you can inspect and control projects, processes, todos, and sc…
Projects and processes from the CLI
The solo projects, solo processes, and solo commands groups let you manage projects and control their processes without touching the app window. All of them require the Solo app to…
Todos and scratchpads from the CLI
The solo todos and solo scratchpads groups give scripts and terminal sessions full access to a project's todos and scratchpads. Both groups are project-scoped, so every command req…
JSON output and scripting
Every Solo CLI command accepts a --json flag that switches from human-readable text to a stable, single-line JSON envelope. Combined with meaningful exit codes, this makes the CLI…

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

Solo

Solo is a lightweight terminal workspace for agents, project commands, and shell sessions. Define your processes once, run everything in one place, get auto-restarts and crash alerts, and expose MCP tools so your agents can see your stack.

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
FeaturesWorkflowPricingCompareAgentsDocsLoginDownloadHelpChangelogThe Agentic Metaharness
Legal
Privacy PolicyTerms of Service
Compare

Solo does not try to become another editor or agent orchestrator. These pages show where Solo fits best: as the local workspace around the tools you already use.

Comparisons
All comparisonsSolo vs CursorSolo vs WindsurfSolo 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