ticktick-cli

# 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)