clickup-cli
CLI cup для ClickUp с файлом скилла: агент читает задачи, пишет комментарии, ведет время и спринты командами.
- 130 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Личный токен ClickUp дает агенту создавать, менять и удалять задачи, комментарии и документы.
- Команды выполняют массовые операции над задачами, поэтому ошибка агента затронет много карточек сразу.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/clickup-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Личный токен ClickUp дает агенту создавать, менять и удалять задачи, комментарии и документы.
- Команды выполняют массовые операции над задачами, поэтому ошибка агента затронет много карточек сразу.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
clickup-cli ставит команду `cup`, через которую агент работает с ClickUp без обращений к API напрямую. Скилл учит агента, какие команды существуют. В терминале списки задач открываются интерактивным выбором, при передаче по конвейеру вывод идет чистым Markdown или JSON с флагом `--json`. Покрыты задачи с подзадачами, зависимостями и массовыми операциями, комментарии с настоящими упоминаниями, чат, документы, учет времени, чек-листы, поля, теги, цели и экспорт. Команда `cup skill` сама находит Claude Code, Codex и OpenCode и кладет файл скилла в нужные каталоги.
Для кого. Разработчикам и менеджерам проектов, которые ведут задачи ClickUp из Claude Code, Codex или OpenCode.
Подходит, если
- Агент берет задачу по ID, делает работу и переводит ее на проверку с комментарием и хешем коммита.
- Утром нужна сводка: что закрыто, что в работе, что просрочено.
- В инициативе надо создать подзадачу под найденный краевой случай.
- Несколько рабочих пространств переключаются профилями `cup profile`.
Не подходит, если
- Нужна работа через MCP-сервер: клиент устроен как CLI с файлом скилла.
- Нет Node 22 или выше.
- Токен нельзя выдавать агенту: команды удаляют и меняют задачи.
Пример запроса к агенту
Прочитай задачу abc123, сделай работу, переведи ее в ревью и оставь комментарий с хешем коммита.Ограничения
Нужны Node 22 или новее и личный токен ClickUp вида `pk_...`. Токен открывает записи и удаление в рабочем пространстве, поэтому для первых запусков заведите профиль на тестовом пространстве. Ответы 429 повторяются с ограничением, а сбои шлюза 502, 503 и 504 повторяются только для чтения: после сбоя записи сверьте состояние в ClickUp. Раздел документов использует API версии 3. Скилл обновляется вместе с пакетом, после обновления `cup` запустите `cup skill` еще раз.
Как отключить. Выполните `npm uninstall -g @krodak/clickup-cli` и удалите файл скилла из каталога агента. Конфиг с токеном лежит в `~/.config/cup/config.json`.
Частые вопросы
Как поставить clickup-cli?
Выполните `npm install -g @krodak/clickup-cli && cup init`, затем `cup auth` для проверки. Есть и вариант через Homebrew: `brew tap krodak/tap` и `brew install clickup-cli`.
Как подключить скилл к Claude Code или Codex?
Запустите `cup skill`: команда находит Claude Code, Codex и OpenCode и ставит файл скилла сама. Для ручной установки есть флаг `--path`, например `cup skill --path ~/.claude/skills/clickup/SKILL.md`.
Как настроить без вопросов, для CI?
Задайте `CU_API_TOKEN` и `CU_TEAM_ID`: тогда файл конфигурации не нужен. Либо выполните `cup init --token pk_... --team ...`.
Почему здесь CLI, а не MCP?
Автор считает, что у CLI с файлом скилла меньше движущихся частей: нет серверного процесса и протокольного слоя. Агент уже умеет запускать команды.
Что делает агент при сбое записи?
CLI не повторяет изменение автоматически: исход мог быть неопределенным. Агент сначала смотрит текущее состояние задачи в ClickUp и только потом решает, повторять ли запись.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыПлагин и MCP для самохостинговой доски задач: агент берет карточку, делает работу и сдает результат с замерами токенов.
Официальный CLI Basecamp с плагинами для Claude Code и Codex позволяет вести проекты и задачи из терминала и через агента
Канбан-доска в терминале на Python, которую Claude Code и другие агенты читают и меняют через CLI или MCP
Локальная доска задач с CLI taskctl и скиллом для Codex, Claude Code и других агентов: заводит issue, двигает статусы и хранит комментарии по правилам
Десктоп-приложение и CLI skm: одна копия скилла в общем хранилище и симлинки во все AI-инструменты
CLI открывает локальную канбан-доску задач Claude Code с зависимостями, текущими действиями и уведомлениями о завершении.
Коротко о README
Репозиторий публикует npm-пакет `@krodak/clickup-cli`, плагин Claude Code и файл скилла. Есть профили для нескольких рабочих пространств, настройка через переменные окружения и документация по покрытию API в `docs/`.