Pp Ticktick

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/productivity/ticktick/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

TickTick — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the ticktick-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install ticktick --cli-only

2. Verify: ticktick-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/productivity/ticktick/cmd/ticktick-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Covers both TickTick APIs: the official Open API and the richer internal V2 surface (habits, focus records, completed-task history, batch ops). The 'note edit' command encodes a field-whitelist write contract that cannot corrupt TEXT-kind daily notes, and the local SQLite mirror powers 'agenda', 'review', 'habits streaks', and 'focus stats' — ritual-shaped commands that replace multi-call fan-outs.

When to Use This CLI

Reach for this CLI whenever an agent task touches TickTick daily notes, habits, focus sessions, or weekly reviews — the surfaces the official API does not expose. It is the safe write path for daily notes and the bounded read path for briefings and reviews.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to edit TickTick calendar events synced from external calendars — that data is read-only in the V2 API
• Do not use raw 'tasks update' on a daily note; use 'note edit'
• Do not use this CLI for Dida365 (China) accounts without changing the base URL — endpoints differ

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Corruption-proof writes

• note edit — Edit your daily note's content with a corruption-proof contract — the command can never flip the note's task kind or break its subtasks.

  Use this instead of a raw task update whenever the target is a daily note; raw updates through generic tools have corrupted notes before.

  ticktick-pp-cli note edit --date today --append "20:15 wrapped the printing-press build" --dry-run

Local state that compounds

• agenda — One command returns today's tasks, habits with checkin state, and focus sessions together.

  Reach for this at session start instead of fanning out list calls; one bounded response covers the whole briefing.

  ticktick-pp-cli agenda --json --select tasks.title,habits.name

• review — Gather a week of completed tasks, daily notes, focus totals, and habit checkins as one structured pack ready for synthesis.

  Use for weekly-review synthesis instead of paging completed tasks and re-reading seven daily notes by hand.

  ticktick-pp-cli review --since 7d --json

• habits streaks — Current streak, longest streak, and at-risk-today flags for every habit.

  Answers 'which habits are about to break' without hand-rolling date math over raw checkins.

  ticktick-pp-cli habits streaks --json

• focus stats — Focus/pomodoro time aggregated per day or per project over any window.

  Use for weekly focus totals instead of scraping raw focus records.

  ticktick-pp-cli focus stats --since 7d --json

Command Reference

completed — Completed task history

• ticktick-pp-cli completed — Completed tasks in a date window

focus — Focus / pomodoro records

• ticktick-pp-cli focus — Focus and pomodoro records, most recent first

habits — Habits and habit checkins

• ticktick-pp-cli habits checkin — Upsert habit checkins (batch add/update)
• ticktick-pp-cli habits checkins — Query habit checkins after a date stamp
• ticktick-pp-cli habits list — List all habits

projects — Projects (lists)

• ticktick-pp-cli projects — List all projects

tags — Tags

• ticktick-pp-cli tags — List all tags

tasks — Tasks — all uncompleted tasks via the V2 sync surface, single-task get, and batch mutations

• ticktick-pp-cli tasks batch — Batch create/update/delete tasks (arrays of task objects; updates must carry id, projectId
• ticktick-pp-cli tasks get — Get a single task by id (full JSON incl. kind, etag, childIds)
• ticktick-pp-cli tasks list — List all uncompleted tasks (from the V2 sync check)

user — Account profile

• ticktick-pp-cli user — Authenticated user profile

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

ticktick-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Morning briefing

ticktick-pp-cli agenda --json --agent

One bounded response with today's tasks, habit state, and focus sessions for a session-start briefing.

Log a focus block to the daily note

ticktick-pp-cli note edit --date today --append "15:00-15:45 client audit prep"

Timestamped append through the corruption-proof write path.

Friday review pack, narrowed for agents

ticktick-pp-cli review --since 7d --agent --select completed.title,notes.content,focus_totals.by_day

Deeply nested week pack narrowed with --select so synthesis doesn't drown in raw JSON.

Which habits are about to break

ticktick-pp-cli habits streaks --json --select name,current_streak,at_risk

Streak math over synced checkins with only the decision-relevant fields.

Weekly focus hours by project

ticktick-pp-cli focus stats --since 7d --by project --json

Aggregated pomodoro/focus durations from the local mirror.

Auth Setup

Two tiers. The V2 internal API (habits, focus, daily notes, batch) authenticates with a session token: set TICKTICK_USERNAME and TICKTICK_PASSWORD and the CLI signs on automatically, or set TICKTICK_SESSION_TOKEN with the 't' cookie from a logged-in browser session (required for Google-SSO accounts without a password). The optional V1 Open API tier uses TICKTICK_API_TOKEN (OAuth bearer from developer.ticktick.com). Requests send a browser-like User-Agent because the API returns 503 to default clients.

Run ticktick-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color --yes.

• Pipeable — JSON on stdout, errors on stderr

• Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  ticktick-pp-cli completed --agent --select id,name,status

• Previewable — --dry-run shows the request without sending

• Offline-friendly — sync/search commands can use the local SQLite store when available

• Non-interactive — never prompts, every input is a flag

• Explicit retries — use --idempotent only when an already-existing create should count as success