ticktick

CLI для TickTick — для людей и AI-агентов

Для людей — цветные таблицы, спиннеры, интерактивная настройка
Для AI-агентов — --json на каждой команде, стабильный формат { ok, data }
Встроенная авторизация — OAuth-приложение встроено, ticktick init и всё работает

Быстрый старт

npm i -g @polza-ai/ticktick-cli

ticktick init                          # открывает браузер, нажали «Разрешить» — готово
ticktick tasks                         # все задачи
ticktick create -t "Купить молоко"     # создать задачу
ticktick complete <id>                 # завершить задачу

Команды

Команда	Описание	Пример
`init`	Настроить подключение (OAuth 2.0)	`ticktick init`
`tasks`	Список задач с фильтрами	`ticktick tasks --priority 5`
`task`	Детали задачи	`ticktick task <id>`
`create`	Создать задачу	`ticktick create -t "Баг" --priority 5`
`update`	Изменить задачу	`ticktick update <id> -t "..." -p 5`
`complete`	Завершить задачу	`ticktick complete <id>`
`delete`	Удалить задачу	`ticktick delete <id>`
`move`	Переместить задачу в другой проект	`ticktick move <id> --to <projectId>`
`completed`	Список завершённых задач	`ticktick completed --from 2026-01-01`
`projects`	Список проектов	`ticktick projects`
`project`	Проект с задачами	`ticktick project <id>`
`project-create`	Создать проект	`ticktick project-create -n "Работа"`
`project-update`	Изменить проект	`ticktick project-update <id> -n "..."`
`project-delete`	Удалить проект	`ticktick project-delete <id>`
`focuses`	Список фокус-сессий	`ticktick focuses --from ... --to ...`
`focus`	Детали фокус-сессии	`ticktick focus <id>`
`focus-delete`	Удалить фокус-сессию	`ticktick focus-delete <id>`
`habits`	Список привычек	`ticktick habits`
`habit`	Детали привычки	`ticktick habit <id>`
`habit-create`	Создать привычку	`ticktick habit-create -n "Read" --type Boolean --repeat "RRULE:FREQ=DAILY;INTERVAL=1"`
`habit-update`	Изменить привычку	`ticktick habit-update <id> -n "..." --goal 2`
`habit-checkin`	Чек-ин привычки	`ticktick habit-checkin <id>`
`habit-checkins`	Чек-ины за период	`ticktick habit-checkins --habits <id> --from 20260101 --to 20260501`

Все команды поддерживают --json для машинного вывода.

Настройка

ticktick init

CLI откроет браузер — нажмите «Разрешить», и всё готово. OAuth-приложение встроено, ничего регистрировать не нужно.

Если хотите использовать своё приложение: ticktick init --custom-app

Интеграция с AI-агентами

ticktick спроектирован как инструмент для AI-агентов: данные идут в stdout (JSON/таблица), логи и спиннеры — в stderr. Флаг --json возвращает стабильный конверт:

{ "ok": true,  "data": { "id": "abc123", "title": "..." } }
{ "ok": false, "error": { "code": "NOT_FOUND", "message": "Не найдено" } }

Inbox

ticktick init определяет ID Inbox (через одноразовый зонд: создать-прочитать-удалить задачу) и сохраняет его как inboxId в ~/.ticktick-cli/config.json. После этого:

ticktick projects показывает Inbox синтетическим элементом с kind: "INBOX".
--project inbox (case-insensitive) — алиас на inboxId в любых командах.
ticktick create без --project явно проставляет projectId: <inboxId>.
ticktick task <id> / update / complete / delete без --project сами найдут задачу в Inbox.

Ограничения OpenAPI:

Листинг Inbox-задач невозможен. Ни /project/{inboxId}/data, ни /task/filter его не отдают, а /api/v2/batch/check/0 требует session-cookie веб-клиента, которой нет у OAuth Bearer. ticktick tasks --project inbox возвращает явную ошибку INBOX_LISTING_UNAVAILABLE — работайте с Inbox-задачами по их ID через ticktick task <id>.
DELETE 200 не значит "удалено сразу". ticktick delete возвращает ok:true, и задача пропадает из listings, но прямой ticktick task <id> сразу после может отдать stale-копию из кэша API. Это поведение TickTick OpenAPI, а не CLI.

Конфигурация

Глобальный конфиг

~/.ticktick-cli/config.json — создаётся через ticktick init. Токен обновляется автоматически через refresh_token.

Проектный конфиг

.ticktick.json — переопределяет настройки для конкретного проекта:

{
  "defaultProject": "<project-id>",
  "defaultTags": ["work"],
  "defaultPriority": 3
}

Полный справочник команд

init

ticktick init [--custom-app] [--project]

Флаг	Описание
`--custom-app`	Использовать своё OAuth-приложение (вместо встроенного)
`--project`	Создать `.ticktick.json` в текущей директории

tasks

ticktick tasks [опции]

Флаг	Описание
`--project <id>`	Фильтр по проекту (или алиас `inbox` — вернёт `INBOX_LISTING_UNAVAILABLE`)
`--priority <n>`	Фильтр по приоритету (0, 1, 3, 5)
`--tag <tag>`	Фильтр по тегу
`--completed`	Включить завершённые задачи
`-l, --limit <n>`	Максимум задач (по умолчанию: 50)
`--sort <field>`	Сортировка: `priority`, `dueDate`, `title`, `sortOrder`
`--json`	JSON-вывод

task

ticktick task <id> [--project <id>] [--json]

Выводит полную информацию: название, описание, статус, приоритет, проект, теги, подзадачи, даты.

create

ticktick create -t "Название" [опции]

Флаг	Описание
`-t, --title <text>`	Название задачи (обязательно)
`--content <text>`	Описание
`--project <id>`	Проект (или алиас `inbox`)
`-p, --priority <n>`	Приоритет: `0` (нет), `1` (низкий), `3` (средний), `5` (высокий)
`--due <date>`	Дедлайн (YYYY-MM-DD или ISO 8601)
`--start <date>`	Дата начала (YYYY-MM-DD или ISO 8601)
`--duration <dur>`	Длительность: `30m`, `1h`, `1h30m`, `1.5h`, `90` (минуты). Считает `dueDate` от `--start` (или `now`). Несовместимо с `--due`
`--all-day`	Без времени (весь день)
`--timezone <tz>`	Часовой пояс (например, `Europe/Moscow`)
`--repeat <rrule>`	Правило повторения (RRULE)
`--sort-order <n>`	Порядок сортировки (целое число; меньше = выше в списке)
`--tag <tags...>`	Теги
`--json`	JSON-вывод

В Open API нет отдельного поля duration — длительность задаётся парой startDate + dueDate. Флаг --duration — удобный шорткат, который вычисляет dueDate.

update

ticktick update <taskId> [опции]

Флаг	Описание
`--project <id>`	ID проекта или алиас `inbox` (если не указан — найдётся автоматически, включая Inbox)
`-t, --title <text>`	Новое название
`--content <text>`	Описание
`-p, --priority <n>`	Приоритет (0, 1, 3, 5)
`--due <date>`	Дедлайн
`--start <date>`	Дата начала
`--all-day`	Без времени
`--timezone <tz>`	Часовой пояс
`--repeat <rrule>`	Правило повторения
`--sort-order <n>`	Порядок сортировки (целое число; меньше = выше в списке)
`--json`	JSON-вывод

move

ticktick move <taskId> --to <projectId> [--from <projectId>] [--json]

--to и --from принимают алиас inbox.

completed

ticktick completed [--project <ids...>] [--from <date>] [--to <date>] [-l <n>] [--json]

project-create / project-update / project-delete

ticktick project-create -n "Название" [--color #F18181] [--view list|kanban|timeline] [--kind TASK|NOTE]
ticktick project-update <id> [-n ...] [--color ...] [--view ...] [--kind ...]
ticktick project-delete <id> [-y]

focuses / focus / focus-delete

ticktick focuses --from <ISO> --to <ISO> [--type pomodoro|timing] [--json]
ticktick focus <focusId> [--type pomodoro|timing] [--json]
ticktick focus-delete <focusId> [--type pomodoro|timing] [-y]

Диапазон не больше 30 дней. Если больше — сервер автоматически сдвигает from.

habits / habit / habit-create / habit-update

ticktick habits [--json]
ticktick habit <habitId> [--json]

ticktick habit-create -n "Read" [--icon habit_reading] [--color #4D8CF5] \
  [--type Boolean] [--goal 1] [--step 1] [--unit Count] \
  [--repeat "RRULE:FREQ=DAILY;INTERVAL=1"] [--record] \
  [--target-days N] [--target-start YYYYMMDD] [--encouragement "..."]

ticktick habit-update <habitId> [-n ...] [--goal ...] [--repeat ...] \
  [--status <n>] [--target-days N] [--target-start YYYYMMDD]

DELETE для привычек в API нет — для архивации используйте habit-update <id> --status 1.

habit-checkin / habit-checkins

ticktick habit-checkin <habitId> [--stamp YYYYMMDD] [--value 1.0] [--goal 1.0] [--status <n>] [--time ISO]
ticktick habit-checkins --habits <id1> <id2> ... --from YYYYMMDD --to YYYYMMDD [--json]

Без --stamp чек-ин делается на сегодня.

complete

ticktick complete <taskId> [--project <id>] [--json]

delete

ticktick delete <taskId> [--project <id>] [-y] [--json]

Флаг	Описание
`--project <id>`	ID проекта или алиас `inbox`
`-y, --yes`	Без подтверждения
`--json`	JSON-вывод

projects

ticktick projects [--json]

project

ticktick project <id> [--json]

Показывает проект и все его задачи.

Разработка

git clone https://github.com/polza-ai/ticktick-cli.git
cd ticktick-cli
npm install

npm run dev -- tasks           # запуск через tsx
npm run build                  # компиляция в dist/
npm run typecheck              # проверка типов

API

CLI покрывает 100% официального TickTick Open API: задачи (CRUD, перемещение, фильтр, завершённые), проекты (CRUD), фокус-сессии (read/delete), привычки (CRUD без delete) и чек-ины.

Требования

Node.js 20+
Аккаунт TickTick

Лицензия

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 10 Commits
bin		bin
src		src
.gitignore		.gitignore
README.md		README.md
TESTING.md		TESTING.md
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

ticktick

Быстрый старт

Команды

Настройка

Интеграция с AI-агентами

Inbox

Конфигурация

Глобальный конфиг

Проектный конфиг

init

tasks

task

create

update

move

completed

project-create / project-update / project-delete

focuses / focus / focus-delete

habits / habit / habit-create / habit-update

habit-checkin / habit-checkins

complete

delete

projects

project

API

Требования

Лицензия

About

Uh oh!

Releases

Packages

Uh oh!

Contributors

Uh oh!

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

ticktick

Быстрый старт

Команды

Настройка

Интеграция с AI-агентами

Inbox

Конфигурация

Глобальный конфиг

Проектный конфиг

init

tasks

task

create

update

move

completed

project-create / project-update / project-delete

focuses / focus / focus-delete

habits / habit / habit-create / habit-update

habit-checkin / habit-checkins

complete

delete

projects

project

API

Требования

Лицензия

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages