kaiten CLI (Swift)
kaiten
CLI для Kaiten на Swift с компактным JSON для jq, плагинами Claude и Cursor и справочным файлом для агентов
- 9 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- CLI покрывает карточки, автоматизации и другие изменяющие операции API Kaiten
- Хранит API-токен в конфигурационном файле на диске
Установка
- Работает в
- Сервисы
Ручная установка
mise use github:AllDmeat/kaitenСтавит последний релиз под вашу платформу, добавьте -g для глобальной установки.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- CLI покрывает карточки, автоматизации и другие изменяющие операции API Kaiten
- Хранит API-токен в конфигурационном файле на диске
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
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.
Частые вопросы
Зачем нужен reference-файл?
Экземпляры Kaiten накапливают сущности с одинаковыми именами, и поиск по имени может незаметно вернуть не ту сущность. Файл с ID решает эту проблему для агентов.
Можно использовать SDK отдельно от CLI?
Да, Swift SDK, на котором построен CLI, доступен как отдельная библиотека для своих интеграций.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Kaiten — все инструментыkaiten-cli (ViktorOgnev)
kaiten-cli
CLI для Kaiten на Python с реестром команд для агентов, автодополнением и тремя бонусными скиллами
kaiten-cli
kaiten
Консольный клиент и MCP-сервер для трекера Kaiten: карточки, комментарии, чек-листы и файлы из терминала или агента
Kaiten MCP
kaiten-mcp
MCP-сервер для Kaiten на Swift: пространства, доски, колонки, дорожки, карточки, комментарии и пользовательские поля
Kaiten CLI и MCP-сервер на Go
kaiten-mcp
Нативный CLI и MCP-сервер для Kaiten на Go с безопасными настройками по умолчанию: инструменты записи выключены, пока их явно не включат
Локальный stdio-сервер на Node.js 24: поиск и правка карточек Kaiten, чек-листы, комментарии и пользовательские поля из Codex и Claude Code
Kaiten MCP Tools: чтение карточек и вложений, 37 инструментов
kaiten-mcp-tools
Npm-пакет только для чтения: 37 инструментов по карточкам, доскам, документам и учету времени, оригиналы вложений скачиваются для разбора агентом
Коротко о README
README на английском показывает установку через mise, готовый релиз или сборку из исходников на Swift, настройку токена в конфиге или переменных окружения и уникальную концепцию reference-файла для агентов. Отдельно расписано управление размером JSON-ответа через --expand с примерами для одного и нескольких уровней вложенности, а также раздел про использование Swift SDK как отдельной библиотеки.