TickTick CLI Skill

Управляйте задачами и проектами в TickTick прямо из командной строки. Этот инструмент предоставляет удобный интерфейс с поддержкой OAuth2-аутентификации, пакетных операций и контроля лимитов API, позволяя автоматизировать повседневную работу.

Установка и настройка

1. Создание приложения TickTick
Перейдите в центр разработчика TickTick, создайте новое приложение и укажите redirect URI: http://localhost:8080. Сохраните Client ID и Client Secret.

2. Аутентификация
Запустите OAuth-процесс, указав ваши учетные данные:

bun run scripts/ticktick.ts auth --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

Проверка статуса:

bun run scripts/ticktick.ts auth --status

Выход из системы:

bun run scripts/ticktick.ts auth --logout

Ручная авторизация (для headless-серверов): используйте флаг --manual, откройте ссылку авторизации в браузере и вставьте полученный redirect URL обратно в CLI.

Основные команды

Просмотр задач

bun run scripts/ticktick.ts tasks
bun run scripts/ticktick.ts tasks --list "Work"
bun run scripts/ticktick.ts tasks --status pending

Можно выводить данные в JSON для автоматизации и интеграций.

Создание задач

bun run scripts/ticktick.ts task "Buy groceries" --list "Personal"
bun run scripts/ticktick.ts task "Review PR" --list "Work" --priority high
bun run scripts/ticktick.ts task "Submit report" --due tomorrow

Поддерживаются описания, приоритеты, сроки и теги.

Обновление задач

bun run scripts/ticktick.ts task "Buy groceries" --update --priority medium
bun run scripts/ticktick.ts task "abc123" --update --due tomorrow

Завершение и отмена

bun run scripts/ticktick.ts complete "Buy groceries"
bun run scripts/ticktick.ts abandon "Old task"

Для массовых операций используйте batch-команды, позволяющие обрабатывать несколько задач за один запрос.

Работа с проектами

bun run scripts/ticktick.ts lists
bun run scripts/ticktick.ts list "New Project"
bun run scripts/ticktick.ts list "Work" --update --color "#00FF00"

Вы можете создавать, переименовывать и настраивать проекты, включая цветовые метки.

Опции и параметры

Приоритеты: none, low, medium, high
Форматы сроков: today, tomorrow, in N days, ISO-дата

Глобальные флаги:

• --json — вывод в формате JSON
• --help — справка по командам

Рекомендации для агентов

При использовании в AI-агентах рекомендуется:

• Всегда использовать --json для обработки данных
• Сначала получать список проектов
• Использовать ID проектов вместо названий
• Проверять статус задачи перед завершением

Ограничения и особенности

API имеет ограничения по количеству запросов — около 100 в минуту и 300 за 5 минут. :

Также есть лимит в 500 задач на проект и отсутствует поддержка некоторых функций, таких как трекинг привычек или фокус-время. :

Хранение конфигурации

Токены и учетные данные сохраняются локально. Файл конфигурации содержит access token, refresh token и параметры приложения — его следует считать чувствительным и защищать соответствующим образом.

Устранение проблем

• Ошибка аутентификации: повторно выполните команду auth
• Проект не найден: проверьте список проектов
• Задача не найдена: уточните название или используйте ID
• Проблемы с токеном: выполните повторную авторизацию