TickTick

Manage tasks and projects via scripts/tt.sh. Full API reference in references/api.md.

Auth: TICKTICK_TOKEN env var (set in shell from Infisical). Timezone: All dates in ART (America/Buenos_Aires, UTC-3). Script appends -03:00 automatically. Inbox ID: inbox131039472

Quick Reference

# Load token (if not already in env)
export TICKTICK_TOKEN=$(infisical secrets get TICKTICK_TOKEN \
  --token="$INFISICAL_TOKEN" --projectId="$INFISICAL_PROJECT_ID" \
  --env=prod --plain 2>/dev/null | tail -1)

TT="bash /root/.openclaw/workspace/skills/ticktick/scripts/tt.sh"

Commands

List projects

$TT projects

List tasks

$TT tasks                          # inbox (default)
$TT tasks --project "Work"         # by name
$TT tasks --project <projectId>    # by ID

Add a task

$TT add "Buy tennis grip"
$TT add "Call accountant" --priority high --due "2026-02-20T10:00:00"
$TT add "Draft email" --project "Work" --priority med --notes "Reply to Yarilin"
$TT add "Review PR" --tag "work,code"

Priority values: none | low | med | high

Complete a task

$TT complete <taskId> --project <projectId>
# Inbox tasks: --project flag optional (defaults to inbox)

Update a task

$TT update <taskId> --project <projectId> --priority high
$TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"

Delete a task

$TT delete <taskId> --project <projectId>

Manage projects

$TT add-project "Tennis"           # creates new list
$TT add-project "Work" --color "#FF5733"
$TT delete-project <projectId>

Workflow

1. Quick capture — if no project specified, task lands in Inbox
2. Find taskId — run $TT tasks or $TT tasks --project X, copy the id from output
3. Find projectId — run $TT projects, copy the id

Display Format

When showing tasks to JMO, format like this:

📋 Inbox — 3 pending

  ○ [HIGH]  Call accountant            — due Feb 20
  ○ [MED]   Review BT analytics
  ○         Buy tennis racket grip

Sort by: priority (high first), then due date. Hide completed tasks unless asked.