Documentation Index
Fetch the complete documentation index at: https://docs.whim.run/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Todos let you capture and organize planned work without consuming compute. Write your instructions now, refine them, and launch as running tasks when ready.
Todos vs tasks
| Todo | Task |
|---|
| Purpose | Planned work — capture intent now, execute later | Active work — runs immediately in a container |
| Container | None (no compute used) | Full isolated environment with AI agent |
| Editable | Body, priority, effort, tags, assignee, model, branch — all editable | Prompt is fixed once launched |
| Cost | Free until launched | Consumes compute units while running |
Press Tab in the composer to toggle between task and todo mode.
Creating a todo
- Open the composer at the bottom of the sidebar
- Press Tab to switch to Todo mode
- Write your instructions
- Press Cmd/Ctrl + Enter or click Send
The todo appears in your task list with a checkbox icon.
Todo fields
Click a todo to open its detail pane and edit:
Body — Rich text with full Markdown support. Describe the work, add context, link to issues, or include code snippets. Editable at any time before launch.
Priority — Set urgency for sorting and triage:
| Priority | Description |
|---|
| Urgent | Needs immediate attention |
| High | Important, should be done soon |
| Medium | Normal priority (default) |
| Low | Nice to have, no rush |
| Effort | Description |
|---|
| Small | Quick fix or minor change |
| Medium | Moderate scope |
| Large | Significant feature or refactor |
Backlog sorting
| Sort | Behavior |
|---|
| Manual | Drag-and-drop ordering |
| Priority | Urgent first, then High, Medium, Low |
| Effort | Small first (quick wins), then Medium, Large |
| Updated | Most recently updated first |
Launching a todo
Click the play button on a todo’s detail pane to launch it. Whim will:
- Create an isolated branch from the todo’s configured remote base branch
- Spin up a container with the selected provider and model
- Start the agent with the todo’s body as the prompt
- Transition the todo to an active running task
If provider, model, or branch aren’t set on the todo, workspace defaults are
used.
Bulk operations
Select multiple todos from the task list to:
- Archive — move selected items out of the active view
- Complete — mark selected items as done
