7.0 KiB
7.0 KiB
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