gh-benjaminjackson-reclaim-skills-reclaim/skills/reclaim-tasks/EXAMPLES.md

Reclaim Tasks: Examples

Comprehensive examples for all Reclaim task workflows. Remember: All write operations (create, update, complete, delete) require confirmation using AskUserQuestion before execution.

Quick Task Capture

Minimal task creation

reclaim create --title "Review documents"

Task with duration only

reclaim create --title "Research competitors" --duration 2

Task with due date

reclaim create --title "Submit report" --due 2025-11-15

Task with priority

reclaim create --title "Fix critical bug" --priority P1

Detailed Task Creation

Complete task specification

reclaim create \
  --title "Write quarterly review" \
  --due 2025-11-30 \
  --priority P2 \
  --duration 4 \
  --time-scheme work \
  --notes "Include metrics from Q3 and Q4"

Task with specific start time

reclaim create \
  --title "Client presentation" \
  --start 2025-11-10T14:00:00 \
  --duration 1.5 \
  --priority P1

Deferred task (start after specific date)

reclaim create \
  --title "Plan 2026 roadmap" \
  --defer 2025-12-01 \
  --duration 3 \
  --priority P2

Task with splitting enabled

# Allow splitting with default minimum chunk
reclaim create \
  --title "Code review backlog" \
  --duration 4 \
  --split

# Allow splitting with 30-minute minimum chunks
reclaim create \
  --title "Email cleanup" \
  --duration 3 \
  --split 0.5

# Splitting with min and max chunk constraints
reclaim create \
  --title "Documentation updates" \
  --duration 6 \
  --split \
  --min-chunk 0.5 \
  --max-chunk 2

Task Updates

Update task title

reclaim update abc123 --title "Updated title"

Change priority

reclaim update abc123 --priority P1

Update due date

reclaim update abc123 --due 2025-11-20

Update duration

reclaim update abc123 --duration 2.5

Multiple updates at once

reclaim update abc123 \
  --title "Refactored title" \
  --priority P2 \
  --duration 3 \
  --due 2025-11-25

Clear a date field

# Clear due date
reclaim update abc123 --due none

# Clear deferred start
reclaim update abc123 --defer clear

# Clear specific start time
reclaim update abc123 --start null

Add or update notes

reclaim update abc123 --notes "Updated context and requirements"

Change time scheme

# Using alias
reclaim update abc123 --time-scheme work

# Using specific scheme ID
reclaim update abc123 --time-scheme ts_abc123def

Listing and Filtering

List active tasks (default)

reclaim
# or explicitly
reclaim list active

List completed tasks

reclaim list completed

List overdue tasks

reclaim list overdue

Get specific task details

reclaim get abc123

List available time schemes

reclaim list-schemes

Task Completion

Mark task as complete (ARCHIVED status)

reclaim complete abc123

Note: This sets the task to ARCHIVED status, which represents truly complete tasks in Reclaim.

Task Deletion

Permanently delete a task

reclaim delete abc123

Warning: This is permanent deletion. Use complete instead if you want to mark a task as done.

Duration Formats

Tasks can have various durations specified in hours:

# 15 minutes
reclaim create --title "Quick check-in" --duration 0.25

# 30 minutes
reclaim create --title "Review PR" --duration 0.5

# 45 minutes
reclaim create --title "Team standup" --duration 0.75

# 1 hour
reclaim create --title "Deep work session" --duration 1

# 90 minutes
reclaim create --title "Workshop prep" --duration 1.5

# 2 hours
reclaim create --title "Client meeting" --duration 2

# 4 hours (half day)
reclaim create --title "Strategic planning" --duration 4

# 8 hours (full day)
reclaim create --title "Conference attendance" --duration 8

Date and Time Formats

Date only (YYYY-MM-DD)

reclaim create --title "Submit proposal" --due 2025-11-30

Date with time (YYYY-MM-DDTHH:MM:SS)

reclaim create --title "Presentation" --start 2025-11-15T14:30:00

Clearing dates

# All of these work to clear a date field
reclaim update abc123 --due none
reclaim update abc123 --defer clear
reclaim update abc123 --start null

Workflow Examples

Morning planning workflow

# List what's scheduled
reclaim list active

# Check overdue items
reclaim list overdue

# Adjust priorities based on day
reclaim update task1 --priority P1
reclaim update task2 --defer 2025-11-08

Creating a project task series

# Phase 1: Research (this week)
reclaim create \
  --title "Research: User interviews" \
  --due 2025-11-08 \
  --priority P1 \
  --duration 3 \
  --split 1

# Phase 2: Design (next week)
reclaim create \
  --title "Design: Wireframes" \
  --defer 2025-11-11 \
  --duration 4 \
  --priority P2

# Phase 3: Implementation (following week)
reclaim create \
  --title "Implementation: Core features" \
  --defer 2025-11-18 \
  --duration 8 \
  --priority P2 \
  --split 2

End of day cleanup

# Complete finished tasks
reclaim complete task1
reclaim complete task2

# Defer tasks that weren't started
reclaim update task3 --defer 2025-11-08

# Review what's coming up
reclaim list active

Time Scheme Examples

Using work hours

reclaim create \
  --title "Code review" \
  --duration 2 \
  --time-scheme work

Using personal time

reclaim create \
  --title "Side project work" \
  --duration 1.5 \
  --time-scheme personal

Finding and using specific schemes

# List all available schemes
reclaim list-schemes

# Use specific scheme ID
reclaim create \
  --title "Deep focus work" \
  --duration 3 \
  --time-scheme ts_abc123def

Private Tasks

Create a private task

reclaim create \
  --title "Personal development review" \
  --duration 1 \
  --private true

Make existing task private

reclaim update abc123 --private true

Make task non-private

reclaim update abc123 --private false

Category and Color

Set event category

reclaim create \
  --title "Team meeting" \
  --duration 1 \
  --category "Meetings"

Set event color

reclaim create \
  --title "Deep work block" \
  --duration 2 \
  --color "blue"

Update category and color

reclaim update abc123 --category "Planning" --color "green"

Confirmation Workflow Example

When a user asks: "Create a task to finish the proposal, P1, due next Friday, 3 hours"

Step 1: Construct the command

reclaim create \
  --title "Finish the proposal" \
  --priority P1 \
  --due 2025-11-14 \
  --duration 3

Step 2: Use AskUserQuestion with:

Ready to create this Reclaim task:

Command: reclaim create --title "Finish the proposal" --priority P1 --due 2025-11-14 --duration 3

This will create:
- Title: "Finish the proposal"
- Priority: P1
- Due: 2025-11-14
- Duration: 3 hours

Proceed?

Step 3: After user confirms, execute the command