kaiten-cli

Консольный клиент для Kaiten — системы управления проектами. Позволяет управлять пространствами, досками, колонками, дорожками и карточками через командную строку. Эффективен для использования ИИ-агентами. Почему kaiten до сих пор не сделали свой, кстати? Написан полностью в соответствии с их API.

Установка

Сборка из исходников

git clone https://gitlab.life-pay.ru/ai/kaiten-cli.git
cd kaiten-cli
make build

Бинарник появится в build/kaiten.

Кросс-платформенная сборка

make cross-build

Собирает под:

• Linux amd64 / arm64
• macOS amd64 / arm64
• Windows amd64

Настройка

Конфигурация через переменные окружения (обе обязательны):

Переменная	Описание	Пример
KAITEN_API_TOKEN	API-токен Kaiten	Токен из настроек Kaiten
KAITEN_URL	URL вашего Kaiten	https://mycompany.kaiten.ru

export KAITEN_API_TOKEN="ваш-токен"
export KAITEN_URL="https://mycompany.kaiten.ru"

Использование

Пространства (spaces)

# Список всех пространств
kaiten spaces list

# Получить пространство по ID
kaiten spaces get 123

Доски (boards)

# Список досок в пространстве
kaiten boards list --space-id 123

# Получить доску по ID
kaiten boards get 456

Колонки (columns)

# Список колонок на доске
kaiten columns list --board-id 456

Дорожки (lanes)

# Список дорожек на доске
kaiten lanes list --board-id 456

Карточки (cards)

# Список карточек на доске (по умолчанию — активные)
kaiten cards list --board-id 456

# Архивные карточки
kaiten cards list --board-id 456 --archived

# Все карточки (активные + архивные)
kaiten cards list --board-id 456 --all

# Получить карточку по ID
kaiten cards get 789

# Создать карточку (по ID колонки)
kaiten cards create \
  --title "Новая задача" \
  --board-id 456 \
  --column-id 10 \
  --lane-id 20 \
  --position 1 \
  --description "Описание задачи" \
  --due-date "2025-12-31T23:59:59Z"

# Создать карточку (по имени колонки)
kaiten cards create \
  --title "Новая задача" \
  --board-id 456 \
  --column-name "Backlog" \
  --lane-name "Default" \
  --size 3

# Обновить карточку (только указанные поля)
kaiten cards update 789 \
  --title "Обновлённое название" \
  --column-id 11

# Переместить карточку по имени колонки
kaiten cards update 789 \
  --board-id 456 \
  --column-name "In Review"

# Удалить карточку
kaiten cards delete 789

# Архивировать карточку
kaiten cards archive 789

# Разархивировать карточку
kaiten cards unarchive 789

Комментарии (comments)

# Список комментариев карточки
kaiten comments list --card-id 789

# Добавить комментарий
kaiten comments add --card-id 789 --text "Текст комментария"

# Добавить комментарий в формате HTML
kaiten comments add --card-id 789 --text "<b>Важно</b>" --type 2

Блокировки (blockers)

# Заблокировать карточку
kaiten blockers block --card-id 789 --reason "Ждём ответа от заказчика"

# Разблокировать (нужен ID блокировки — берётся из ответа block)
kaiten blockers unblock --card-id 789 --blocker-id 1234

# Удалить блокировку
kaiten blockers delete --card-id 789 --blocker-id 1234

Теги (tags)

# Список всех тегов компании
kaiten tags list

# Теги на карточке
kaiten tags card-tags --card-id 789

# Добавить тег к карточке (по имени)
kaiten tags add --card-id 789 --name "urgent"

# Удалить тег с карточки
kaiten tags remove --card-id 789 --tag-id 123

Участники (members)

# Список участников карточки
kaiten members list --card-id 789

Чеклисты (checklists)

# Создать чеклист
kaiten checklists create --card-id 789 --name "Чеклист задачи"

# Получить чеклист с пунктами
kaiten checklists get --card-id 789 --checklist-id 111

# Добавить пункт
kaiten checklists add-item --card-id 789 --checklist-id 111 --text "Первый пункт"

# Отметить пункт выполненным
kaiten checklists check --card-id 789 --checklist-id 111 --item-id 222

# Снять отметку
kaiten checklists uncheck --card-id 789 --checklist-id 111 --item-id 222

# Удалить пункт
kaiten checklists delete-item --card-id 789 --checklist-id 111 --item-id 222

# Удалить чеклист
kaiten checklists delete --card-id 789 --checklist-id 111

Флаги создания карточки

Флаг	Обязательный	Описание
--title	Да	Название карточки
--board-id	Да	ID доски
--column-id	Да*	ID колонки
--column-name	Да*	Имя колонки (вместо --column-id)
--lane-id	Нет	ID дорожки
--lane-name	Нет	Имя дорожки (вместо --lane-id)
--position	Нет	Позиция: 1 — вверху, 2 — внизу
--description	Нет	Описание
--type-id	Нет	ID типа карточки
--size	Нет	Размер карточки (число)
--due-date	Нет	Дедлайн (ISO 8601)

• Обязателен один из двух: --column-id или --column-name

Флаги обновления карточки

Флаг	Описание
--title	Новое название
--board-id	ID доски (нужен при использовании --column-name или --lane-name)
--column-id	ID новой колонки (перемещение)
--column-name	Имя новой колонки (вместо --column-id)
--lane-id	ID новой дорожки
--lane-name	Имя новой дорожки (вместо --lane-id)
--type-id	Новый ID типа карточки
--description	Новое описание
--size	Новый размер карточки (число)
--due-date	Новый дедлайн (ISO 8601)

Формат вывода

Все команды возвращают JSON с отступами. Пример:

{
  "id": 789,
  "title": "Моя карточка",
  "board_id": 456,
  "column_id": 10,
  "type_id": 5,
  "size_text": "3",
  "condition": "in_progress"
}

Для обработки вывода удобно использовать jq:

# Получить только названия карточек
kaiten cards list --board-id 456 | jq '.[].title'

# Отфильтровать карточки по колонке
kaiten cards list --board-id 456 | jq '[.[] | select(.column_id == 10)]'

Коды ошибок API

Код	Описание
401	Невалидный или отсутствующий токен
402	Функция недоступна на вашем тарифе
403	Недостаточно прав доступа
404	Ресурс не найден
429	Превышен лимит запросов (5 запросов/сек)

Разработка

# Сборка
make build

# Запуск тестов
make test

# Линтинг (нужен golangci-lint)
make lint

# Очистка
make clean