ManuelHettich

TickTick CLI

生活服务v1.0.0
作者:ManuelHettich更新于 2026-05-11ticktick@clawhub_manuelhettich/ticktick
个人计划效率习惯#Batch

据 AlphaMoat 统计,截至 2026-10,TickTick CLI 累计下载 10,543 次、获 23 个星标,按累计下载量在本次参与排名的 10,914 个 AI 技能中排名第 2,583 位,在「生活服务」分类(550 个)中排名第 83 位。

列表默认按累计下载量排序,也可按星标排序;详情页排名按累计下载量计算。

累计下载
1.1万
星标
23
全站下载量排名
#2,583
全站前 24% · 「生活服务」前 16%
平台累计下载星标评论
ClawHub ↗7,28023-
SkillHub ↗1.1万23—

各平台的计数口径不同,统计时间不一致。

这个技能是做什么的

它支持 OAuth 授权、任务与项目查询、创建和更新,并提供批量操作与限流处理。凭据和令牌保存在本地配置文件;完成、放弃或批量修改任务前,应先核对项目和任务标识。

资料发布于 2026-10-27

可以用来做什么

  • 查看项目和任务状态
  • 创建、更新或完成任务
  • 按项目筛选后执行任务操作

什么时候用

  • 需要从终端管理 TickTick 任务时
  • 需要整理项目或筛选任务时
  • 完成、放弃或批量修改任务之前

示例提示词

以下是根据技能文档生成的示例,不代表实际运行结果。

列出这个项目中尚未完成的任务,并显示状态。
为指定项目创建一项带截止日期的任务。
先核对任务标识和当前状态,再完成目标任务。

月度数据趋势

累计下载1.1万
5,4638,1911.1万2026-03 · 累计下载 5,8392026-05 · 累计下载 6,2752026-06 · 累计下载 6,4982026-07 · 累计下载 6,7942026-08 · 累计下载 6,9502026-09 · 累计下载 7,0472026-10 · 累计下载 1.1万26-0326-0926-10
星标23
2122232026-03 · 星标 212026-05 · 星标 222026-06 · 星标 222026-07 · 星标 232026-08 · 星标 232026-09 · 星标 232026-10 · 星标 2326-0326-0926-10

2026-09 起统计方法调整:同名技能按作者分别统计,并覆盖全部技能。图中虚线为调整前的月份,与之后的数据不直接比较,也不计算跨越调整的增长。 该技能有同名的其他版本,调整前的数据归属当前下载量最大的这一个。

月份累计下载环比星标
2026-101.1万—23
2026-097,047—23
2026-086,950+2.3%23
2026-076,794+4.6%23
2026-066,498+3.6%22
2026-056,275—22
2026-035,839—21

SKILL.md 原文

以下是作者发布的原始文件,按纯文本显示,本站未做修改或审核;其中的链接不可点击,命令请核实后再运行。抓取于 2026-10-23。

6.8 KB · ClawHub v1.0.0
---
name: ticktick
description: Manage TickTick tasks and projects from the command line with OAuth2 auth, batch operations, and rate limit handling.
---

# TickTick CLI Skill

Manage TickTick tasks and projects from the command line.

## Setup
展开全部(共 252 行)

### 1. Register a TickTick Developer App

1. Go to [TickTick Developer Center](https://developer.ticktick.com/manage)
2. Create a new application
3. Set the redirect URI to `http://localhost:8080`
4. Note your `Client ID` and `Client Secret`

### 2. Authenticate

```bash
# Set credentials and start OAuth flow
bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

# Check authentication status
bun run scripts/ticktick.ts auth --status

# Logout (clear tokens, keep credentials)
bun run scripts/ticktick.ts auth --logout
```

### Headless / Manual Authentication

```bash
# Use manual mode on headless servers
bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET --manual
```

This prints an authorization URL. Open it in a browser, approve access, then copy the full redirect URL (it looks like `http://localhost:8080/?code=XXXXX&state=STATE`) and paste it back into the CLI.

The CLI will open your browser to authorize access. After approving, tokens are stored in `~/.clawdbot/credentials/ticktick-cli/config.json`.

## Commands

### List Tasks

```bash
# List all tasks
bun run scripts/ticktick.ts tasks

# List tasks from a specific project
bun run scripts/ticktick.ts tasks --list "Work"

# Filter by status
bun run scripts/ticktick.ts tasks --status pending
bun run scripts/ticktick.ts tasks --status completed

# JSON output
bun run scripts/ticktick.ts tasks --json
```

### Create Task

```bash
# Basic task creation
bun run scripts/ticktick.ts task "Buy groceries" --list "Personal"

# With description and priority
bun run scripts/ticktick.ts task "Review PR" --list "Work" --content "Check the new auth changes" --priority high

# With due date
bun run scripts/ticktick.ts task "Submit report" --list "Work" --due tomorrow
bun run scripts/ticktick.ts task "Plan vacation" --list "Personal" --due "in 7 days"
bun run scripts/ticktick.ts task "Meeting" --list "Work" --due "2024-12-25"

# With tags
bun run scripts/ticktick.ts task "Research" --list "Work" --tag research important
```

### Update Task

```bash
# Update by task name or ID
bun run scripts/ticktick.ts task "Buy groceries" --update --priority medium
bun run scripts/ticktick.ts task "abc123" --update --due tomorrow --content "Updated notes"

# Limit search to specific project
bun run scripts/ticktick.ts task "Review PR" --update --list "Work" --priority low
```

### Complete Task

```bash
# Mark task as complete
bun run scripts/ticktick.ts complete "Buy groceries"

# Complete with project filter
bun run scripts/ticktick.ts complete "Review PR" --list "Work"
```

### Abandon Task (Won't Do)

```bash
# Mark task as won't do
bun run scripts/ticktick.ts abandon "Old task"

# Abandon with project filter
bun run scripts/ticktick.ts abandon "Obsolete item" --list "Do"
```

### Batch Abandon (Multiple Tasks)

```bash
# Abandon multiple tasks in a single API call
bun run scripts/ticktick.ts batch-abandon <taskId1> <taskId2> <taskId3>

# With JSON output
bun run scripts/ticktick.ts batch-abandon abc123def456... xyz789... --json
```

Note: `batch-abandon` requires task IDs (24-character hex strings), not task names. Use `tasks --json` to get task IDs first.

### List Projects

```bash
# List all projects
bun run scripts/ticktick.ts lists

# JSON output
bun run scripts/ticktick.ts lists --json
```

### Create Project

```bash
# Create new project
bun run scripts/ticktick.ts list "New Project"

# With color
bun run scripts/ticktick.ts list "Work Tasks" --color "#FF5733"
```

### Update Project

```bash
# Rename project
bun run scripts/ticktick.ts list "Old Name" --update --name "New Name"

# Change color
bun run scripts/ticktick.ts list "Work" --update --color "#00FF00"
```

## Options Reference

### Priority Levels
- `none` - No priority (default)
- `low` - Low priority
- `medium` - Medium priority
- `high` - High priority

### Due Date Formats
- `today` - Due today
- `tomorrow` - Due tomorrow
- `in N days` - Due in N days (e.g., "in 3 days")
- `next monday` - Next occurrence of weekday
- ISO date - `YYYY-MM-DD` or full ISO format

### Global Options
- `--json` - Output results in JSON format (useful for scripting)
- `--help` - Show help for any command

## Agent Usage Tips

When using this skill as an AI agent:

1. **Always use `--json` flag** for machine-readable output
2. **List projects first** with `lists --json` to get valid project IDs
3. **Use project IDs** rather than names when possible for reliability
4. **Check task status** before completing to avoid errors

Example agent workflow:
```bash
# 1. Get available projects
bun run scripts/ticktick.ts lists --json

# 2. Create a task in a specific project
bun run scripts/ticktick.ts task "Agent task" --list "PROJECT_ID" --priority high --json

# 3. Later, mark it complete
bun run scripts/ticktick.ts complete "Agent task" --list "PROJECT_ID" --json
```

## Configuration

Tokens are stored in `~/.clawdbot/credentials/ticktick-cli/config.json`:
```json
{
  "clientId": "YOUR_CLIENT_ID",
  "clientSecret": "YOUR_CLIENT_SECRET",
  "accessToken": "...",
  "refreshToken": "...",
  "tokenExpiry": 1234567890000,
  "redirectUri": "http://localhost:8080"
}
```

Note: Credentials are stored in plaintext. The CLI attempts to set file permissions to 700/600; treat this file as sensitive.

The CLI automatically refreshes tokens when they expire.

## Troubleshooting

### "Not authenticated" error
Run `bun run scripts/ticktick.ts auth` to authenticate.

### "Project not found" error
Use `bun run scripts/ticktick.ts lists` to see available projects and their IDs.

### "Task not found" error
- Check the task title matches exactly (case-insensitive)
- Try using the task ID instead
- Use `--list` to narrow the search to a specific project

### Token expired errors
The CLI should auto-refresh tokens. If issues persist, run `bun run scripts/ticktick.ts auth` again.

## API Notes

This CLI uses the [TickTick Open API v1](https://developer.ticktick.com/api).

### Rate Limits
- **100 requests per minute**
- **300 requests per 5 minutes**

The CLI makes multiple API calls per operation (listing projects to find task), so bulk operations can hit limits quickly.

### Batch Endpoint
The CLI supports TickTick's batch endpoint for bulk operations:
```
POST https://api.ticktick.com/open/v1/batch/task
{
  "add": [...],    // CreateTaskInput[]
  "update": [...], // UpdateTaskInput[]
  "delete": [...]  // { taskId, projectId }[]
}
```
Use `batch-abandon` to abandon multiple tasks in one API call. The batch API method is also exposed for programmatic use.

### Other Limitations
- Maximum 500 tasks per project
- Some advanced features (focus time, habits) not supported by the API

「生活服务」分类下的热门技能

育儿大师.Skill生活服务

育儿大师.Skill——0-18 岁全场景家庭养育支持,服务对象是家长。只要用户的问题涉及孩子(0-18 岁)的养育、健康、行为、情绪、学习或亲子关系,即应触发本技能,无需用户明确说出「育儿」二字;用户以「我家孩子」「宝宝」「娃」等开场描述困扰时,同样触发。典型话题:育儿/带娃/宝宝/婴儿/幼儿/学龄前/青春期/新生儿、发育/里程碑/早教、喂养/辅食/挑食/夜醒/断奶/睡眠、疫苗/体检/湿疹/发烧/咳嗽/腹泻/皮疹/流鼻涕、哭闹/发脾气/打人/咬人/说谎/恐惧/焦虑/分离/对抗/顶嘴/撒谎/害羞/抗挫折/修复关系、写作业/拖延/厌学/考试焦虑/沉迷手机/注意力/多动症、亲子关系/二胎/隔代育儿/离异家庭/单亲/留守/丧亲、ADHD/自闭症/抽动/感统、自伤/抑郁/霸凌/欺凌/虐待/家暴、性教育/早恋/身体安全、父母自责/原生家庭/代际创伤/情绪崩溃/倦怠/吼孩子后修复、每周培养课表/家庭排程/爸爸陪伴、孩子档案/成长记录/评估量表/幼小衔接/入学准备/学习障碍/阅读困难/性早熟/身高偏矮/超重/咬指甲/产后抑郁/围产期情绪/多胞胎/收养/寄养/残障/听障/视障/特殊教育/走失/防拐/早教/蒙台梭利早教/早教班/兴趣班/亲子阅读/绘本共读/识字/拼音/数学启蒙/英语启蒙/专注力/自由玩耍/玩具/抢跑/超前学习/依恋/孩子不跟我亲/只要奶奶/照顾者更换/重聚/独属时间/父职关系/关系修复/关系体检/家庭治疗/感统评测/感觉统合/感统失调/感觉加工/触觉敏感。

↓ 307.6万★ 87user_741dc82b
防骗大师.Skill生活服务

防骗大师.Skill:你身边的生活类防骗专家。 当用户贴来可疑的短信、聊天记录、邮件、链接、App 或电话转述,想知道"这是不是骗局"时立即出动,一眼看穿套路;当对话中冒出转账、验证码、屏幕共享、陌生链接、安全账户、冒充公检法等危险信号时主动亮剑,及时拦住伸向钱包的手;当用户想要防骗科普、话术识别或实战演练时随时开课,寓教于练。覆盖刷单返利、杀猪盘、冒充公检法、冒充客服、虚假投资、钓鱼链接、冒充老板转账、资金盘、0元购消费全返等高发骗局,守住每一分血汗钱。

↓ 203.8万★ 36user_741dc82b
anti-fraud生活服务

防骗大师.Skill:你身边的生活类防骗专家。 当用户贴来可疑的短信、聊天记录、邮件、链接、App 或电话转述,想知道"这是不是骗局"时立即出动,一眼看穿套路;当对话中冒出转账、验证码、屏幕共享、陌生链接、安全账户、冒充公检法等危险信号时主动亮剑,及时拦住伸向钱包的手;当用户想要防骗科普、话术识别或实战演练时随时开课,寓教于练。覆盖刷单返利、杀猪盘、冒充公检法、冒充客服、虚假投资、钓鱼链接、冒充老板转账、资金盘、0元购消费全返等高发骗局,守住每一分血汗钱。

↓ 173.0万★ 2user_814dbe54
育儿专家生活服务

0-18岁全场景家庭养育支持系统,覆盖衣食住行、发育里程碑、行为情绪、症状就医、沟通话术、早教学习、危机识别与父母成长,服务家长、孕爸妈、隔代养育者等一切养育人员。当用户咨询带娃、辅食、睡眠、穿衣、出行安全、写作业、叛逆、健康症状等问题时使用。不诊断不处方。

↓ 54.3万★ -user_8b569cc9
parenting-expert生活服务

育儿大师.Skill——0-18 岁全场景家庭养育支持,服务对象是家长。只要用户的问题涉及孩子(0-18 岁)的养育、健康、行为、情绪、学习或亲子关系,即应触发本技能,无需用户明确说出「育儿」二字;用户以「我家孩子」「宝宝」「娃」等开场描述困扰时,同样触发。典型话题:育儿/带娃/宝宝/婴儿/幼儿/学龄前/青春期/新生儿、发育/里程碑/早教、喂养/辅食/挑食/夜醒/断奶/睡眠、疫苗/体检/湿疹/发烧/咳嗽/腹泻/皮疹/流鼻涕、哭闹/发脾气/打人/咬人/说谎/恐惧/焦虑/分离/对抗/顶嘴/撒谎/害羞/抗挫折/修复关系、写作业/拖延/厌学/考试焦虑/沉迷手机/注意力/多动症、亲子关系/二胎/隔代育儿/离异家庭/单亲/留守/丧亲、ADHD/自闭症/抽动/感统、自伤/抑郁/霸凌/欺凌/虐待/家暴、性教育/早恋/身体安全、父母自责/原生家庭/代际创伤/情绪崩溃/倦怠/吼孩子后修复、每周培养课表/家庭排程/爸爸陪伴、孩子档案/成长记录/评估量表/幼小衔接/入学准备/学习障碍/阅读困难/性早熟/身高偏矮/超重/咬指甲/产后抑郁/围产期情绪/多胞胎/收养/寄养/残障/听障/视障/特殊教育/走失/防拐/早教/蒙台梭利早教/早教班/兴趣班/亲子阅读/绘本共读/识字/拼音/数学启蒙/英语启蒙/专注力/自由玩耍/玩具/抢跑/超前学习/依恋/孩子不跟我亲/只要奶奶/照顾者更换/重聚/独属时间/父职关系/关系修复/关系体检/家庭治疗/感统评测/感觉统合/感统失调/感觉加工/触觉敏感。

↓ 53.0万★ -user_814dbe54
Weather生活服务

用 curl 直接向公共天气服务取当前天气与预报的技能。

↓ 36.0万★ 482Peter Steinberger
腾讯新闻生活服务

腾讯新闻 CLI 综合信息服务技能。

↓ 23.6万★ 43u_8c6b225d
同程程心 Tongcheng Chengxin Travel Search生活服务

同程程心—基于同程旅行大模型的在线旅游搜索,提供机票、火车票、酒店、度假、攻略、行程规划、特价票、汽车票、景区门票等实时查询,官方数据保障,一键预订,旅行更轻松愉快。

↓ 11.5万★ 7tongcheng-ai

ManuelHettich 的其他技能

数据月份:2026-10 · 下载/星标数聚合自公开技能注册库(ClawHub、SkillHub),按月更新。口径说明见数据方法。