Skip to Content
DocumentationTasks

Tasks

The Tasks tab is the primary workflow hub of Chloe, managing your work through a Kanban-based system with four columns.

Tasks Focus View

Columns

Tasks flow through four columns representing their lifecycle:

ColumnDescription
PlanningBacklog for new tasks waiting to be started
In ProgressActive work with linked terminal instances
ReviewCompleted work awaiting your approval
DoneFinished tasks (persistent archive)

View Modes

Toggle between views with the / key.

Focus View (Default)

The focus view shows your active tasks in a list format with a details panel on the right.

  • Left panel: Active tasks (Planning + In Progress)
  • Right panel: Selected task details
  • Bottom section: Completed tasks

Kanban View

The Kanban view displays all four columns visually, similar to a traditional Kanban board.

Task Types

Each task has a type displayed as a colored badge:

TypeColorUse Case
FeaturePurpleNew functionality
BugRedSomething broken
ChoreGrayMaintenance work
TaskBlueGeneral tasks

When creating a task, Chloe can use AI to automatically classify the task type based on its title and description.

Creating Tasks

Press a to add a new task

A text input appears at the bottom of the screen.

Type your task title

Be descriptive - this will be sent to Claude when the task starts.

Press Enter to save

The task appears in the Planning column.

Creating a task

Starting a Task

When you’re ready to work on a task:

  1. Navigate to the task in the Planning column
  2. Press s to start the task

This automatically:

  • Moves the task to In Progress
  • Creates a new terminal instance
  • Sends your task to Claude Code with the prompt:
    Work on this task: Title: [your task title] Description: [your task description]

Starting a task

Terminal Focus Mode

When a task is In Progress, press Enter to enter Terminal Focus Mode:

  • All keyboard input goes directly to the terminal
  • Watch Claude work on your task in real-time
  • Press Esc to exit and return to task navigation

Terminal focus mode

Review Workflow

When Claude completes a task, it automatically moves to the Review column. Press Enter on a review task to see your options:

ActionDescription
Review in IDEOpens the changed files in your configured IDE
Review in TerminalOpens a terminal at the worktree location
Request ChangesSend feedback to Claude for revisions
Merge to BranchMerge the worktree changes to your main branch

If merge conflicts are detected, the “Merge to Branch” option changes to “Resolve Conflicts” and Claude will be prompted to fix them.

Keybindings

KeyAction
j / Select next task
k / Select previous task
h / Previous column (Kanban view)
l / Next column (Kanban view)
gJump to first task
GJump to last task
TabSwitch between active/done panels
/Toggle Focus/Kanban view

Actions

KeyAction
aAdd new task
eEdit task title
dDelete task (with confirmation)
sStart task (Planning → In Progress)
EnterContext-aware action (start/focus/review)
t / TJump to task’s terminal instance

Task Properties

Each task stores:

  • Title: The task name shown in the list
  • Description: Detailed information sent to Claude
  • Type: Feature, Bug, Chore, or Task
  • Instance ID: Link to the terminal running this task
  • Worktree Info: Git branch and path for isolated work
  • Created At: When the task was created
  • Is Paused: Whether the task is temporarily paused
Last updated on