ticktick
Manage TickTick tasks and projects. Use when the user asks to add, create, or capture a task or todo; list, show, or review pending tasks; complete or check off a task; update a task's priority, due date, notes, or tags; delete a task or list; create or manage a project/list; or see what's due today or overdue. Also handles quick captures like "remind me to..." or "don't let me forget...".
来源信息
- 仓库
- 0juano/agent-skills
- 最近来源活动
- 2026年7月2日 14:24
- 检测到的 SKILL.md 语言
- 英语
- 星标
- 0
- Forks
- 0
安装方式
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
检查来源文件
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
文件资源管理器
3 个文件正在显示 SKILL.md
SKILL.md
来源说明 · 只读预览- name
- ticktick
- description
- Manage TickTick tasks and projects. Use when the user asks to add, create, or capture a task or todo; list, show, or review pending tasks; complete or check off a task; update a task's priority, due date, notes, or tags; delete a task or list; create or manage a project/list; or see what's due today or overdue. Also handles quick captures like "remind me to..." or "don't let me forget...".
- license
- MIT
- metadata
- {"author":"0juano","version":"1.2.0"}
# TickTick
Manage tasks and projects via `{baseDir}/scripts/tt.sh`. Full API reference in `references/api.md`.
**Auth:** `TICKTICK_TOKEN` env var — a TickTick personal access token (`tp_*`),
used directly as a Bearer token; no OAuth flow needed. Load it from your
secrets manager or shell profile.
**Timezone:** due dates get the local UTC offset appended automatically.
Override with `TICKTICK_UTC_OFFSET` (e.g. `-03:00`) and optionally
`TICKTICK_TIMEZONE` (IANA name, e.g. `America/Buenos_Aires`).
**Inbox:** the per-user inbox project id is auto-discovered from the API.
Set `TICKTICK_INBOX_ID` to skip the extra lookup call.
## Quick Reference
```bash
TT="bash {baseDir}/scripts/tt.sh"
```
## Commands
### List projects
```bash
$TT projects
```
### List tasks
```bash
$TT tasks # inbox (default)
$TT tasks --project "Work" # by name
$TT tasks --project <projectId> # by ID
```
### Add a task
```bash
$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 client"
$TT add "Review PR" --tag "work,code"
```
Priority values: `none` | `low` | `med` | `high`
### Complete a task
```bash
$TT complete <taskId> --project <projectId>
# Inbox tasks: --project flag optional (defaults to inbox)
```
### Update a task
```bash
$TT update <taskId> --project <projectId> --priority high
$TT update <taskId> --title "New title" --due "2026-02-25T09:00:00"
```
### Delete a task
```bash
$TT delete <taskId> --project <projectId>
```
### Manage projects
```bash
$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 the user, format like this:
```
📋 Inbox — 3 pending
○ [HIGH] Call accountant — due Feb 20
○ [MED] Review analytics
○ Buy tennis racket grip
```
Sort by: priority (high first), then due date. Hide completed tasks unless asked.
在 GitHub 查看