Task Monitoring Guide

After submitting tasks, you can monitor their progress, check detailed status, and manage execution through several commands and real-time notifications.

Listing All Tasks

View all tasks across all states:

:LovelaceTasks

Output Format

Tasks are displayed in a split window organized 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 Information Shown

Each task displays:

Navigation

While the task list is open:

• j/k: Move up/down through list
• q: Close task list window

Checking Individual Task Status

For detailed information about a specific task:

:LovelaceTaskStatus task_abc123

Detailed Status Output

# Task Status: task_abc123

**Description**: Refactor to async/await
**Status**: running
**Agent**: 550e8400-e29b-41d4-a716-446655440000
**Created**: 2025-12-28 10:35:00
**Started**: 2025-12-28 10:35:05
**Progress**: 65%

## Progress Updates
- 10:35:05 - Task started
- 10:35:12 - Analyzing code structure
- 10:35:28 - Generating refactored code

Status Values

Progress Notifications

The extension automatically sends notifications as tasks progress:

Notification Timeline

Task Submitted:

Task submitted (task_abc123) - Status: queued

Task Started (~1-5 seconds later):

[Task abc123] Started: Analyzing code...

Progress Updates (every 10-30 seconds during execution):

[Task abc123] Progress: Generating refactored code...
[Task abc123] Progress: Running validation checks...

Task Completed:

[Task abc123] Completed: 2 files changed

Notification Behavior

• Frequency: Maximum 1 notification per 5 seconds per task
• Grouping: Multiple rapid updates are grouped
• Persistence: Notifications appear as vim.notify() messages
• History: Check :messages to see all past notifications

Monitoring Long-Running Tasks

For tasks that take several minutes:

1. Submit Task

V50j  " Select large code block
:LovelaceTask
" Description: Comprehensive refactoring of module

2. Periodically Check Status

:LovelaceTaskStatus task_abc123

Watch for progress percentage and progress updates.

3. Monitor Agent Workers

:LovelaceAgents

Verify agent is still active and task is executing.

4. Watch Notifications

Progress notifications appear automatically. No manual checking needed for most tasks.

Cancelling Tasks

If a task is taking too long or was submitted incorrectly:

:LovelaceCancel task_abc123

Cancellation Behavior

1. Daemon sends stop signal to agent worker
2. Task status changes to "cancelled"
3. Agent worker becomes idle
4. Notification shown: "Task task_abc123 cancelled"

When to Cancel

• Task is taking longer than expected
• Wrong task description was entered
• Need to free up agent worker for higher priority task
• Task appears stuck (no progress updates for 5+ minutes)

Note: Cannot cancel completed tasks.

Task Lifecycle Timeline

Understanding typical timing helps with monitoring:

Fast Tasks (< 30 seconds)

Simple refactoring, type additions, small fixes:

00:00 - Submit task
00:01 - Agent pickup (queued → running)
00:25 - Task complete
00:25 - Result buffer opens

Medium Tasks (30 seconds - 2 minutes)

Complex refactoring, multi-file changes:

00:00 - Submit task
00:02 - Agent pickup
00:10 - Progress: Analyzing dependencies
00:45 - Progress: Applying changes
01:30 - Task complete

Long Tasks (2-5 minutes)

Large-scale refactoring, comprehensive analysis:

00:00 - Submit task
00:05 - Agent pickup
01:00 - Progress: Processing files
02:30 - Progress: Generating diffs
04:00 - Progress: Validation
04:45 - Task complete

Filtering and Search (Lua API)

For advanced monitoring, use the Lua API:

Filter by Workspace

:lua require("lovelace").list_tasks("workspace_id")

Filter by Status

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

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

Batch Task Monitoring

When you've submitted multiple tasks:

Monitor Overall Progress

:LovelaceTasks

Shows all tasks and their states in one view.

Check Agent Capacity

:LovelaceAgents

See how many agents are busy vs. idle:

## Busy Workers (3)
- Agent 1: Processing task_abc123
- Agent 2: Processing task_def456
- Agent 3: Processing task_ghi789

## Idle Workers (1)
- Agent 4: Available

Sequential Monitoring

For critical tasks, monitor individually:

:LovelaceTaskStatus task_abc123
" Wait for completion...

:LovelaceTaskStatus task_def456
" Check next task...

Troubleshooting Monitoring Issues

Task Not Appearing in List

Symptom: :LovelaceTasks doesn't show recently submitted task

Solutions:

1. Check submission success:

   vim

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

2. Verify connection:

   vim

   :LovelaceHealth
   

3. Check workspace filter (if using Lua API)

Progress Notifications Not Appearing

Symptom: No progress updates for running task

Solutions:

1. Check notification settings:

   lua

   require("lovelace").setup({
     ui = {
       progress_style = "notify"  -- or "both"
     }
   })
   

2. Verify task is actually running:

   vim

   :LovelaceTaskStatus task_abc123
   

3. Check messages history:

   vim

   :messages
   

"Task not found" Error

Symptom: :LovelaceTaskStatus shows "Task not found"

Solutions:

1. Verify task ID is correct (check :messages for submission confirmation)

2. Check task might be very old (tasks may be pruned after 24 hours)

3. Verify daemon connection:

   vim

   :LovelaceHealth
   

Next Steps

• Agent Management - Understand agent worker pool
• Task Submission - Learn to submit effective tasks
• :LovelaceTasks Reference - Full command documentation
• :LovelaceTaskStatus Reference - Status command details

Related Documentation

• :LovelaceTasks Command - List all tasks
• :LovelaceTaskStatus Command - Check task status
• :LovelaceCancel Command - Cancel running tasks
• Configuration Deep Dive - Notification settings