Skip to content

Background Tasks

Background tasks let you spin off work to a separate agent while you continue working in your main session. Each task runs on its own git branch in a worktree.

  1. Open the commands menu with / or Ctrl+P and select TaskStart a background task
  2. Or press n in the Agents panel (Ctrl+3 / Alt+3)

When launching a task you can configure:

FieldDescription
Task promptDescribe what the agent should do
Base branchBranch to start from (defaults to main)
Branch nameAuto-generated or custom branch name
Execution targetLocal worktree or Remote

Background tasks appear in the Agents panel where you can monitor progress, view diffs, or kill them.

Use the Agents panel to:

  • monitor progress
  • inspect task diffs
  • open task actions
  • kill a running task if needed
  • Side Panel — Background tasks live in the Agents section
  • Modes — Swarm mode for broader parallel orchestration