Todos are project-scoped tasks you can keep in Solo alongside commands, terminals, and agents. They are useful for tracking handoffs, blockers, and follow-up work without leaving the project.
Opening todos
Open a project's Todos section from the sidebar or command palette. The list shows the selected project's todos and lets you create a new todo from the header.
If the sidebar section is hidden, todos can still be opened from the command palette. Todo visibility in the sidebar is controlled from Settings -> Notes & todos.
Todo fields
Each todo can include:
- A title and Markdown notes.
- A status: Open, In progress, Backlog, or Completed.
- A priority: High, Medium, or Low.
- Tags.
- Blocker relationships to other todos in the same project.
- Comments in the activity timeline.
Solo saves title, body, priority, tags, and blockers as you edit. Todo notes use the same Markdown editor toolbar as scratchpads.
Finding and organizing todos
The todo list supports filtering by search text, blocker state, status, priority, and tag. You can group the list by priority, status, availability, tag, or a flat list, and sort by priority, title, created time, updated time, or completed time.
When multiple todos are selected, bulk actions can update their status or add and remove tags.
Blockers
Use Blocked by to mark work that must finish before the current todo can proceed. Use Blocking to mark other todos that depend on the current todo.
The list can filter for blocked, unblocked, or blocking todos, and the availability grouping separates ready work from blocked work.
Seeing what an agent is working on
Agents can lock todos through Solo's todo agent tools to signal what they are actively working on. When the Todo locks terminal pin is enabled and the selected process holds one or more locks, its terminal shows one aggregate todo-lock badge in the top-right context cluster.
The badge reports the total number of locked todos. Open it to see a scrollable panel of locked todo titles, then select a todo in the panel to open its detail view.
With the pin enabled, the badge and panel refresh when locks are acquired or released, and the panel lists locked todos owned by MCP session actors bound to that process. MCP todo_lock uses a 300-second lease by default; lease_ttl_seconds must be from 1 through 86,400 seconds, and expired leases are ignored and pruned. Closing a process releases locks owned by MCP session actors only when those actors become fully unbound. An actor still bound to another process keeps its locks until that association closes, the lock is explicitly released, or the lease expires.
Moving and linking
Todo actions include copying a Solo link, changing status or priority, moving the todo to another project, and deleting it. Moving a todo preserves its comments and completion state, but clears blockers and locks because blocker relationships are project-scoped.
Comments and activity
The detail view shows system activity for creation and updates plus comments. Press Enter in the comment box to submit a comment, or Shift+Enter for a line break.