kaiten CLI (Swift)
kaiten
CLI для Kaiten на Swift с компактным JSON для jq, плагинами Claude и Cursor и справочным файлом для агентов
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- CLI покрывает карточки, автоматизации и другие изменяющие операции API Kaiten
- Хранит API-токен в конфигурационном файле на диске
Установка
Ручная установка
mise use github:AllDmeat/kaitenСтавит последний релиз под вашу платформу, добавьте -g для глобальной установки.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CLI печатает компактный JSON в stdout для карточек, пространств, пользователей, спринтов и остальных сущностей Kaiten, чтобы удобно пропускать через jq или скрипты. По умолчанию вложенные сущности сворачиваются до id, а флаг --expand возвращает названные поля на один уровень вглубь, что экономит размер ответа. Есть отдельный ключ reference в конфиге: файл в любом формате (JSON, YAML, Markdown, текст) с ID сущностей и рабочими заметками, который читают только агенты вместо поиска по имени, ненадежного из-за одноименных сущностей в Kaiten. CLI сам не пишет и не читает этот файл без вашего одобрения, только предлагает дополнения. Свифт-SDK, на котором построен CLI, доступен отдельно как библиотека. В репозитории есть плагины для Claude Code и Cursor через .claude-plugin и .cursor-plugin.
Для кого. Для команд на Kaiten, которым нужен предсказуемый JSON-вывод для скриптов и надежная работа агента с ID вместо поиска по имени.
Подходит, если
- Нужен компактный JSON-вывод Kaiten для обработки через jq или собственные скрипты
- Нужно, чтобы агент надежно находил сущности по ID, а не по имени, которое может повторяться
- Нужен готовый плагин для Claude Code или Cursor, а не ручная настройка MCP
Не подходит, если
- Нужен MCP-протокол, а не CLI-инструмент: у автора есть отдельный kaiten-mcp
- Не хотите собирать Swift-проект и нет платформы с готовым релизом под вашу ОС
- Не нужен reference-файл и достаточно обычного поиска по имени
Пример запроса к агенту
Покажи карточки доски 84 в JSON и разверни владельца и теги для карточки 123Ограничения
Готовые релизы даются под конкретные платформы, для остальных нужна сборка через swift build -c release. Reference-файл это соглашение, а не встроенная база данных: агент сам решает, что в него писать, и делает это только с вашего одобрения. Токен API хранится в конфиге ~/.config/kaiten/config.json или переменных окружения для CI.
Как отключить. Удалите инструмент командой mise uninstall или удалите бинарник kaiten из PATH, а также файл ~/.config/kaiten/config.json.
Проверка безопасности
- CLI покрывает карточки, автоматизации и другие изменяющие операции API Kaiten
- Хранит API-токен в конфигурационном файле на диске
Коротко о README
README на английском показывает установку через mise, готовый релиз или сборку из исходников на Swift, настройку токена в конфиге или переменных окружения и уникальную концепцию reference-файла для агентов. Отдельно расписано управление размером JSON-ответа через --expand с примерами для одного и нескольких уровней вложенности, а также раздел про использование Swift SDK как отдельной библиотеки.
Частые вопросы
Зачем нужен reference-файл?
Экземпляры Kaiten накапливают сущности с одинаковыми именами, и поиск по имени может незаметно вернуть не ту сущность. Файл с ID решает эту проблему для агентов.
Можно использовать SDK отдельно от CLI?
Да, Swift SDK, на котором построен CLI, доступен как отдельная библиотека для своих интеграций.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI