Docs menu
DocsAPI reference

Propose a task

Suggest a follow-up task as a dismissible Start chip in the host UI.

Suggest a follow-up task as a dismissible Start chip in the host UI (top-right corner). The chip is INERT until the user clicks Start — which spins off a fresh Code chat seeded with the description. Capability: proposeTask (declared, never prompts).

const { id } = await window.chatoss.proposeTask.propose({
  title: 'Add dark mode',
  description: 'Add a dark theme to the settings page.',
  projectRoot: folder,   // optional: the project the task should run in
  boardId: '…',          // optional: a Kanban board to attach
  worktree: true,        // optional: run in its own git worktree (default true)
});

Use it after a meaningful chunk of work to hand the user a natural next step — never as a way to start work unrequested.