Solo's free tier lets you use every part of the app without a paid license, with limits on projects and managed processes.
Limits
| Resource | Free limit |
|---|---|
| Primary projects | 4 |
| Processes | 20 |
"Processes" means commands, agents, and terminals managed by Solo. Linked checkout/worktree projects do not count toward the four-primary-project quota.
What happens at the limit
- If you are at 4 primary projects, adding another primary project opens the license prompt. Linked checkout/worktree projects do not count toward this limit.
- If you are at 20 processes, adding another process opens the license prompt.
- If you are unlicensed and already over the process limit, Solo blocks process starts until you activate a license or remove processes.
- If you are unlicensed and only over the project limit, Solo blocks adding projects. Your existing processes still start.
- If you deactivate a license while over the free process limit, Solo returns to the free tier locally and stops running managed processes. Being over only the project limit doesn't stop anything.
The license dialog says which limit applies: Process starts are blocked., New projects are blocked., or New projects and process starts are blocked.
Upgrade path
Activate a license from Settings > Account or the title bar prompt to remove free-tier limits. By default, Cmd/Ctrl+, opens Settings; you can change this shortcut in Settings > Hotkeys. See Activating a License for the steps.