# Reclaim Tasks

> Manage tasks in Reclaim.ai calendar scheduling app. Use when creating, updating, listing, completing, or deleting Reclaim tasks, or working with calendar scheduling, task priorities, time blocking, or task duration management. Use when this capability is needed.

- Skill: `tomevault-io/reclaim-tasks` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/reclaim-tasks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/reclaim-tasks/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/reclaim-tasks

---


# Reclaim Tasks

Manage CRUD operations for tasks in Reclaim.ai using the `reclaim` CLI.

## Installation Check

**IMPORTANT**: If a `reclaim` command fails with a "binary not found" or "command not found" error:

1. Check if the CLI is installed:
```bash
which reclaim
```

2. If not installed, install it automatically:
```bash
gem install reclaim
```

3. If automatic installation fails, inform the user that they need to install Ruby first, then run `gem install reclaim`.

4. After installation, verify it works:
```bash
reclaim --help
```

**Do not preemptively check for installation** - only perform these steps when a command actually fails.

## Mandatory Confirmation Workflow

**CRITICAL**: For ALL write operations (create, update, complete, delete), you MUST:

1. Parse the user's request and construct the `reclaim` command
2. Use the AskUserQuestion tool to show the command and get confirmation
3. Only execute the command after user approval

**Read operations** (list, get, list-schemes) can execute immediately without confirmation.

## Quick Command Reference

### Read Operations (no confirmation needed)
```bash
reclaim                    # List active tasks (default)
reclaim list active        # List active tasks (explicit)
reclaim list completed     # List completed tasks
reclaim list overdue       # List overdue tasks
reclaim get TASK_ID        # Get task details
reclaim list-schemes       # List available time schemes
```

### Write Operations (REQUIRE confirmation)
```bash
# Create
reclaim create --title "TITLE" [OPTIONS]

# Update
reclaim update TASK_ID [OPTIONS]

# Complete
reclaim complete TASK_ID

# Delete
reclaim delete TASK_ID
```

## Common Options

- `--title TITLE` - Task title
- `--due DATE` - Due date (YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS, or "none" to clear)
- `--priority P1|P2|P3|P4` - Task priority
- `--duration HOURS` - Duration in hours (0.25 = 15min, 1.5 = 90min)
- `--split [CHUNK_SIZE]` - Allow task splitting (optional min chunk size)
- `--defer DATE` - Start after this date (or "none" to clear)
- `--start DATE` - Specific start time (or "none" to clear)
- `--time-scheme SCHEME` - Time scheme ID or alias (work, personal, etc.)
- `--notes TEXT` - Task notes/description

## Example Workflow with Confirmation

**User request**: "Create a task called 'Write proposal' due Friday, P1 priority, 3 hours"

**Your response**:
1. Construct command: `reclaim create --title "Write proposal" --due 2025-11-07 --priority P1 --duration 3`
2. Use AskUserQuestion to confirm:
   ```
   Ready to create this Reclaim task:

   Command: reclaim create --title "Write proposal" --due 2025-11-07 --priority P1 --duration 3

   This will create a P1 task with 3 hours duration due on 2025-11-07.

   Proceed?
   ```
3. After approval, execute the command

## Additional Resources

- [EXAMPLES.md](EXAMPLES.md) - Comprehensive examples for all workflows
- [REFERENCE.md](REFERENCE.md) - Complete option and command reference

## Date Formats

- Standard: `YYYY-MM-DD` (e.g., 2025-11-07)
- With time: `YYYY-MM-DDTHH:MM:SS` (e.g., 2025-11-07T14:30:00)
- Clear date: `none`, `clear`, or `null`

## Priority Levels

- `P1` - Highest priority
- `P2` - High priority
- `P3` - Medium priority
- `P4` - Low priority

## Time Scheme Aliases

- `work`, `working hours`, `business hours` → Work time schemes
- `personal`, `off hours`, `private` → Personal time schemes

## Understanding Task Status

**CRITICAL**: The `reclaim list active` output shows status COMPLETE with checkmarks (✓) for tasks that are
**done scheduling** (past their assigned time blocks), NOT tasks that are marked as "done".

- Status: COMPLETE in API (✓ symbol) = Task's scheduled time is in the past
- Status: SCHEDULED (○ symbol) = Task's scheduled time is in the future

**A task is only truly "done" after you run `reclaim complete TASK_ID`**. Until then, all tasks in
the active list are open work items, regardless of checkmarks or "COMPLETE" status in the API
response.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/benjaminjackson) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->