Todo Lane Pipeline

Turn a captured todo into Vibe Lane work without moving the task to another tool. You can attach files, let an agent triage the request, refine it in a focused chat, and dispatch it to a lane.

Every stage is optional. Todos continue to work as ordinary notes when you do not attach files, enable triage, refine, or dispatch them.

Pipeline at a glance

See Quick Todos & Sticky Notes for capture and todo management. To create or edit lanes, see Vibe Lanes.

Attach files to a todo

Link files to give triage, refinement, and dispatched work direct context without copying them.

1. Open a todo in the Todos surface.
2. Drag a file onto the todo detail pane.

You can also use your configured inline file-search trigger in the notes editor or thread composer, then select a file from the results.

Add a line number to a path, such as src/Parser.swift:120, to open the file at that line. Attached files appear as chips in the todo detail; click a chip to open the file in CrispyVibe.

Links can point outside your projects. If a linked file is moved or deleted, its chip shows a missing state so you can remove or replace it. Removing a todo or file link never deletes the file itself.

Configure background triage

Choose a triage mode in App Settings > Agents > Todo Pipeline > Auto-triage. The setting applies to every VibeSpace.

After you stop editing an eligible todo, triage waits about 10 seconds and then runs quietly in the background. It can add a suggested-lane chip, a question-count chip, and a short summary to the todo thread. Todos created or edited by agents through the Agent CLI are triaged the same way.

Triage does not rewrite your title, notes, color, links, or status. Short errands and todos without useful lane work may be skipped without adding chips or messages. If you edit a todo while triage is running, CrispyVibe discards that result and triages the edited version.

Refine a todo

Use Refine when a todo needs a clearer goal, completion criteria, or constraints before dispatch.

1. Open the todo.
2. Click Refine.
3. Answer the agent’s questions in the chat.
4. Review the changes written back into the todo.

The chat starts with the todo, attached files, and available triage findings. As you agree on the work, the agent updates the todo’s notes, and those changes appear in the detail pane.

You can close Refine at any time without losing the todo updates. While a refine session exists, the button reads Resume refine and reopens the conversation when the session is still available; otherwise, a new chat starts from the todo’s current content.

With your explicit agreement in the chat, the refine agent can dispatch the todo for you. It uses the same dispatch rules as the app.

Dispatch to a Vibe Lane

Dispatch sends the todo’s title, project, attached files, and prepared inputs to a lane.

1. Open the todo.
2. Click Send to Vibe Lane….
3. Under Choose a Vibe Lane, select a lane. The triage suggestion is preselected when available.
4. Review the pre-filled inputs.
5. Fill any inputs listed under This Vibe Lane still needs:.
6. Click Dispatch.

If required information is still missing, the button reads Dispatch anyway (asks later). The task starts and asks for the missing values through the lane’s normal Needs you flow. A todo tracks one active lane task at a time; you can dispatch it again after the current task finishes, stops, or is deleted.

The todo thread receives one progress message each time the task is dispatched, needs input, stops, or finishes. The todo also shows a chip with the linked task’s state and lane, such as Running · Fix a bug; in the todo detail, select the chip to open the task in Vibe Lanes. When the task finishes, CrispyVibe offers one-click completion of the todo. To complete it automatically instead, enable Complete the todo when its Vibe Lane task finishes in App Settings > Agents > Todo Pipeline. A stopped task never completes the todo.

Deleting a dispatched todo does not cancel its lane task. Manage active work from the Vibe Lanes dashboard.

Use the pipeline from the CLI

Every pipeline action in the app has an Agent CLI equivalent. Agents and scripts can link files with crispy todo file add, read triage results with crispy todo triage show, and dispatch with crispy todo dispatch. CLI dispatch refuses to start when required inputs are unresolved unless you pass --allow-unresolved, and refuses a todo that already has an active task. See Dispatch an existing todo for syntax.

Troubleshooting

Triage chips do not appear

Check App Settings > Agents > Todo Pipeline > Auto-triage and confirm that an ACP agent is configured. Triage skips short errands and may skip VibeSpace-level todos unless All todos is selected. Triage runs only on new or edited todos, not on your existing backlog.

A file chip says the file is missing

The linked file was moved or deleted. Remove the chip or attach the file again at its new path.

Dispatch reports unresolved inputs

The lane’s first step needs information that is not in the todo. Add the missing values in the dispatch review, use Refine to work through them, or proceed and answer when the task enters Needs you.

Refine starts a new conversation

The previous session is unavailable. The new conversation starts with the todo’s current title, notes, links, and triage result, so saved refinement work remains on the todo.

Related docs

• Quick Todos & Sticky Notes
• Vibe Lanes
• Agent CLI: todo commands