:LovelaceTasks

List all tasks with their current status, organized by state.

Command Signature

:LovelaceTasks

Alias: :LTasks

Description

The :LovelaceTasks command displays all tasks in a dedicated buffer, organized by status (running, queued, completed). This provides a comprehensive overview of your task activity and current workload.

What it shows:

• Running tasks with assigned agents
• Queued tasks waiting for workers
• Recently completed tasks
• Task IDs for reference
• Task descriptions
• Time since completion

When to use:

• Checking task status across all tasks
• Monitoring batch task progress
• Finding task IDs for detailed status checks
• Verifying task queue capacity

Usage

Basic Usage

:LovelaceTasks

Opens a split window with all tasks organized by status.

From Lua

require("lovelace.commands").tasks()

Output Format

Tasks are displayed in sections by status:

# Tasks

## Running Tasks
- task_abc123 | "Refactor to async/await" | Agent: 550e8400... | Running

## Queued Tasks
- task_def456 | "Add types" | Agent: (pending) | Queued

## Completed Tasks
- task_ghi789 | "Fix bug" | Agent: 550e8401... | Completed (2m ago)
- task_jkl012 | "Add tests" | Agent: 550e8402... | Completed (5m ago)

Task Information Columns

Each task displays:

Navigation

While the task list is open:

Task States Explained

Running Tasks

Tasks currently being executed by agent workers:

## Running Tasks
- task_abc123 | "Refactor code" | Agent: 550e8400-e29b... | Running

What it means:

• Agent is actively processing the task
• You'll receive progress notifications
• Cannot cancel until agent responds
• Check progress with :LovelaceTaskStatus task_abc123

Queued Tasks

Tasks waiting for available agent workers:

## Queued Tasks
- task_def456 | "Add types" | Agent: (pending) | Queued

What it means:

• All agents are currently busy
• Task will start when agent becomes available
• FIFO order (first in, first out)
• Check agent availability with :LovelaceAgents

Completed Tasks

Tasks that have finished execution:

## Completed Tasks
- task_ghi789 | "Fix bug" | Agent: 550e8401... | Completed (2m ago)

What it means:

• Task finished successfully
• Results are available
• Time indicates how long ago it completed
• Can view results with :LovelaceTaskStatus task_ghi789

Common Scenarios

Scenario 1: All Tasks Completed

# Tasks

## Running Tasks
(none)

## Queued Tasks
(none)

## Completed Tasks
- task_abc123 | "Refactor code" | Agent: 550e8400... | Completed (1m ago)
- task_def456 | "Add types" | Agent: 550e8401... | Completed (3m ago)

Interpretation: All work is complete, agents are idle.

Next step: Submit new tasks or continue editing.

Scenario 2: Active Workflow

# Tasks

## Running Tasks
- task_abc123 | "Refactor module A" | Agent: 550e8400... | Running
- task_def456 | "Refactor module B" | Agent: 550e8401... | Running

## Queued Tasks
- task_ghi789 | "Refactor module C" | Agent: (pending) | Queued

## Completed Tasks
- task_jkl012 | "Refactor module D" | Agent: 550e8402... | Completed (30s ago)

Interpretation: Batch refactoring in progress, 2 agents busy, 1 task waiting.

Next step: Wait for completion or monitor individual tasks.

Scenario 3: Queue Backlog

# Tasks

## Running Tasks
- task_abc123 | "Complex analysis" | Agent: 550e8400... | Running

## Queued Tasks
- task_def456 | "Task 1" | Agent: (pending) | Queued
- task_ghi789 | "Task 2" | Agent: (pending) | Queued
- task_jkl012 | "Task 3" | Agent: (pending) | Queued
- task_mno345 | "Task 4" | Agent: (pending) | Queued

## Completed Tasks
(none)

Interpretation: Single agent working on complex task, backlog building.

Next step: Check agent capacity with :LovelaceAgents or wait for completion.

Filtering and Search

Filter by Workspace (Future Feature)

:LovelaceTasks workspace=my-project

Show only tasks for specific workspace.

Filter by Status (Lua API)

-- Only running and queued tasks
require("lovelace").list_tasks(nil, {"running", "queued"})

-- Only completed tasks
require("lovelace").list_tasks(nil, {"completed"})

Task Management Workflows

Batch Task Monitoring

After submitting multiple tasks:

" Submit tasks
:LovelaceTask  " Task 1
:LovelaceTask  " Task 2
:LovelaceTask  " Task 3

" Monitor progress
:LovelaceTasks

" Check periodically
:LovelaceTasks

Finding Task IDs

Need to check detailed status:

" List all tasks
:LovelaceTasks

" Find task ID in output
" task_abc123 | "My important task" | ...

" Get detailed status
:LovelaceTaskStatus task_abc123

Verifying Completion

Before submitting more work:

:LovelaceTasks

" Check if queued tasks section is empty
" If yes, agents are ready for more work

Troubleshooting

Task Not Appearing in List

Symptom: Recently submitted task doesn't show in :LovelaceTasks

Solutions:

1. Check submission success:

   vim

   :messages
   " Look for "Task submitted (task_xxx)" message
   

2. Verify connection:

   vim

   :LovelaceHealth
   

3. Refresh task list:

   vim

   :LovelaceTasks
   " Close and reopen
   

Tasks Stuck in Queued State

Symptom: Tasks remain in "Queued" for extended period

Solutions:

1. Check agent availability:

   vim

   :LovelaceAgents
   " Look for idle workers
   

2. Verify agents are working:

   vim

   :LovelaceAgents
   " Check if busy agents show recent activity
   

3. Check daemon logs:

   bash

   localhost-ctl logs | grep task
   

Empty Task List

Symptom: :LovelaceTasks shows no tasks but you've submitted some

Solutions:

1. Verify task submission:

   vim

   :messages
   " Check for submission confirmations
   

2. Check workspace filter (if using Lua API):

   • Ensure not filtering to wrong workspace
   • Try without workspace filter

3. Check daemon connection:

   vim

   :LovelaceHealth
   

Integration Patterns

Pre-Workflow Check

Before starting intensive work:

:LovelaceTasks

" If queue is empty and no running tasks:
" All agents available for new work

Batch Task Submission

" Submit multiple tasks
:LovelaceTask  " Refactor module 1
:LovelaceTask  " Refactor module 2
:LovelaceTask  " Refactor module 3

" Monitor batch progress
:LovelaceTasks

" Wait for all to complete
" Check periodically with :LovelaceTasks

Productivity Tracking

End of session:

:LovelaceTasks

" Review completed tasks section
" See what you accomplished this session

Advanced Usage

Programmatic Access

local lovelace = require("lovelace")
local connection = lovelace.get_connection()

connection:call("tasks.list", {
  workspace_id = "my-workspace",
  status_filter = {"running", "queued"}
}, function(result, error)
  if result then
    for _, task in ipairs(result.tasks) do
      print(task.id .. ": " .. task.description)
    end
  end
end)

Custom Task Display

-- Create custom task list display
local function show_my_tasks()
  local lovelace = require("lovelace")
  local tasks = lovelace.get_tasks()

  -- Filter to your tasks
  local my_tasks = vim.tbl_filter(function(task)
    return task.workspace == "my-workspace"
  end, tasks)

  -- Custom display logic
  for _, task in ipairs(my_tasks) do
    print(task.status .. ": " .. task.description)
  end
end

Related Commands

Next Steps

• :LovelaceTaskStatus - Detailed task information
• Task Monitoring Guide - Complete monitoring workflows
• :LovelaceAgents - View agent worker status
• :LovelaceTask - Submit new tasks

Related Documentation

• Task Monitoring Guide - Complete task monitoring workflows
• Agent Management Guide - Understanding agent capacity
• Task Submission Guide - Best practices for submitting tasks