Ticktick Full

---
name: ticktick-cli
description: Operate TickTick through the `ticktick` command-line interface, including authentication, read/query flows, and safe mutations for tasks, projects, folders, columns, tags, habits, user info, focus analytics, and sync payloads. Use when users ask to run TickTick terminal commands, parse TickTick CLI JSON output, resolve IDs, or fix TickTick CLI configuration/auth failures.
version: 1.0.3
metadata:
  openclaw:
    requires:
      env:
        - TICKTICK_CLIENT_ID
        - TICKTICK_CLIENT_SECRET
        - TICKTICK_ACCESS_TOKEN
        - TICKTICK_USERNAME
        - TICKTICK_PASSWORD
---

# TickTick CLI

Use this skill to execute TickTick workflows directly from terminal commands with deterministic output handling.

## Execution Policy

1. Execute the requested `ticktick ...` command first. Do not run version or tool-presence pre-checks.
2. If execution fails because CLI is missing, load `references/setup-and-auth.md` and follow install recovery flow.
3. If execution fails due auth/config issues, load `references/setup-and-auth.md` and run guided auth before retrying the original command.
4. Keep auth recovery CLI-only. Do not improvise custom SDK/Python token exchange scripts.
5. Use `--help` only as recovery when a command fails due unknown flags/arguments or missing required params.

## Defaults

- Prefer `--json` on all data commands and parse structured output.
- Resolve names to IDs before mutations; never guess identifiers.
- Apply read -> mutate -> verify for every write operation.
- Prefer explicit `--project PROJECT_ID` for task mutations when deterministic behavior matters.
- Use explicit date formats (`YYYY-MM-DD` for date-only fields, ISO datetime for timed fields).

## Safety

- Require explicit user confirmation before install/environment changes.
- Never use risky system-install flags unless the user explicitly asks for that path.
- Never print secrets or tokens in user-visible output.
- Require explicit user confirmation before destructive operations:
  - `tasks delete`
  - `projects delete`
  - `folders delete`
  - `columns delete`
  - `tags delete`
  - `tags merge`
  - `habits delete`

## Reference Map

Load only the file needed for the active area.

- [Setup and auth](references/setup-and-auth.md)
- [Tasks](references/tasks.md)
- [Projects](references/projects.md)
- [Folders](references/folders.md)
- [Columns](references/columns.md)
- [Tags](references/tags.md)
- [Habits](references/habits.md)
- [User, focus, sync](references/user-focus-sync.md)
- [Troubleshooting](references/troubleshooting.md)