Skip to main content

Task Management Commands

Commands for viewing, monitoring, and managing tasks.

Viewing Tasks​

bloom list​

List all tasks, optionally filtered by status.

bloom list [status]

Examples:

bloom list              # All tasks
bloom list todo         # Only todo
bloom list in_progress  # Currently running
bloom list done         # Completed
bloom list blocked      # Needs intervention

Output:

Phase 1: Setup
  [done]        create-models      Create database models
  [in_progress] implement-service  Implement service layer

Phase 2: API
  [todo]        create-endpoints   Create API endpoints

bloom show​

Show detailed information about a task.

bloom show <taskid>

Output:

Task: implement-service
Title: Implement service layer
Status: in_progress
Phase: 1
Agent: claude-code

Dependencies:
  ✓ create-models (done)

Instructions:
  Create UserService with CRUD operations.

Acceptance Criteria:
  - All methods are async
  - Proper error handling

Notes:
  - Added validation for email

bloom next​

Show tasks available for execution.

bloom next [agent]

Examples:

bloom next          # All available tasks
bloom next agent-1  # Tasks for specific agent

bloom agents​

List agents and their current tasks.

bloom agents

Output:

Agents:
  claude-code-1
    Current: implement-service
    Completed: 3

  claude-code-2
    Current: idle
    Completed: 2

Monitoring​

bloom dashboard​

Live task monitoring with auto-refresh.

bloom dashboard

Refreshes every 10 seconds showing:

  • Task counts by status
  • Active tasks
  • Recent completions
  • Pending questions

bloom validate​

Check tasks for errors.

bloom validate

Checks:

  • Unique task IDs
  • Valid dependencies
  • Required fields
  • No circular dependencies

Status Management​

bloom done​

Mark a task as completed.

bloom done <taskid>

bloom block​

Mark a task as blocked.

bloom block <taskid>

Use when a task cannot proceed without human intervention.

bloom todo​

Reset a task to todo status.

bloom todo <taskid>

bloom ready​

Mark a task as ready for agent execution.

bloom ready <taskid>

bloom start​

Mark a task as in progress.

bloom start <taskid>

bloom assign​

Assign a task to a specific agent.

bloom assign <taskid> <agent>

Example:

bloom assign implement-auth claude-code-1

Task Operations​

bloom note​

Add a note to a task.

bloom note <taskid> <note>

Examples:

bloom note impl-auth "Using bcrypt with cost factor 12"
bloom note impl-auth "Found edge case with empty passwords"

Notes are stored in ai_notes and visible to future agents.

bloom reset​

Reset a stuck task.

bloom reset <taskid>
bloom reset --stuck  # Reset ALL stuck tasks

Resets task to todo and clears assignment.

Examples​

Monitoring Workflow​

# Watch task progress
watch -n 5 bloom list

# Or use dashboard
bloom dashboard

Intervening in Tasks​

# Block a task that needs discussion
bloom block implement-auth

# Add context
bloom note implement-auth "Need to clarify auth requirements"

# After discussion, continue
bloom todo implement-auth

Recovering from Errors​

# Task stuck in_progress
bloom reset stuck-task-id

# Reset all stuck tasks
bloom reset --stuck

# Re-run
bloom run