feishu-cli
CLI для Feishu с двусторонней конвертацией Markdown и девятью скиллами: Claude Code ведет чаты, почту и календарь.
- 1 438 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- С токеном пользователя агент читает почту и личные чаты, отправляет сообщения и письма, согласует заявки и меняет права доступа к документам.
- Ключи приложения хранятся в файле `~/.feishu-cli/config.yaml`, а установщик запускается из сети через `curl | bash`.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/riba2534/feishu-cli/main/install.sh | bashПервая команда из README: определяет платформу и ставит бинарный файл с проверкой sha256.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- С токеном пользователя агент читает почту и личные чаты, отправляет сообщения и письма, согласует заявки и меняет права доступа к документам.
- Ключи приложения хранятся в файле `~/.feishu-cli/config.yaml`, а установщик запускается из сети через `curl | bash`.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
feishu-cli переводит работу в Feishu в команды терминала: документы, вики, электронные и многомерные таблицы, сообщения, почту, календарь, задачи, согласования, видеовстречи и облачный диск. Главная функция — двусторонняя конвертация Markdown и документов Feishu: поддержано больше сорока типов блоков, а блоки Mermaid и PlantUML превращаются в редактируемые доски. К CLI прилагаются девять скиллов по областям, от документов и хранилища до сообщений, почты и встреч. Команда `feishu-cli skills install` кладет их в `~/.claude/skills` в версии, совпадающей с установленным CLI. Для надежной работы агента есть `--dry-run` у операций записи, ключи идемпотентности против повторной отправки и вывод через `--jq` и `--format`. При опечатке в команде или флаге CLI выдает ошибку и подсказывает правильное написание.
Для кого. Работающим в Feishu и желающим, чтобы Claude Code сам создавал документы, писал в чаты и вел задачи.
Подходит, если
- Markdown-отчет из репозитория надо выложить в Feishu документом с таблицами и диаграммами Mermaid.
- Документ Feishu с картинками нужно выгрузить в Markdown и положить рядом с кодом.
- Агент должен прочитать личную переписку с коллегой по его адресу почты и ответить в группе.
- Встречу надо найти в календаре и завести по ней задачи.
- По видеовстрече требуются расшифровка и конспект для разбора.
Не подходит, если
- Команда не пользуется Feishu, и CLI нечего подключать.
- Нужна поддержка самого вендора: проект ведет независимый автор, у вендора есть собственный CLI.
- Агенту нельзя давать доступ к почте и личным перепискам: часть функций работает только с токеном пользователя.
Пример запроса к агенту
Импортируй `report.md` в Feishu документом «Технический отчет» и пришли мне ссылку, сначала покажи план через `--dry-run`.Ограничения
Нужно приложение Feishu. Команда `feishu-cli config create-app --save` создает его по ссылке с подтверждением через Feishu, а права приложению вручную открывают на странице разрешений. Поиск, почта, видеовстречи и часть операций с диском требуют токена пользователя из `feishu-cli auth login`. Документация на китайском. Навыки привязаны к версии CLI 1.43.0 и новее. Установщик пишет бинарный файл в `/usr/local/bin` и запускается из сети через `curl | bash`. Документ, созданный от имени приложения, принадлежит ему, и без входа пользователя вы его в Feishu не увидите.
Как отключить. Удалите бинарный файл `feishu-cli` и каталоги скиллов `feishu-cli-*` из `~/.claude/skills`. Конфигурацию с ключами приложения удалите вместе с `~/.feishu-cli/` и отзовите ключи в консоли Feishu.
Частые вопросы
Как поставить feishu-cli и скиллы для Claude Code?
Выполните `curl -fsSL https://raw.githubusercontent.com/riba2534/feishu-cli/main/install.sh | bash`, затем `feishu-cli skills install --dry-run` для просмотра и `feishu-cli skills install` для установки в `~/.claude/skills`. Скиллы можно взять и через `npx skills add`, но их версия может разойтись с CLI.
Чем вход от имени приложения отличается от входа пользователя?
Большинство операций идет от имени приложения по ключам App ID и App Secret. Токен пользователя нужен для поиска, согласований, почты, видеовстреч и ряда операций с диском: один раз выполните `feishu-cli auth login`, дальше токен обновляется сам.
Как загрузить Markdown в Feishu?
Выполните `feishu-cli doc import report.md --title "Технический отчет"`. Обратная выгрузка идет командой `feishu-cli doc export <document_id> -o doc.md`. Блоки Mermaid в файле станут досками, а неудавшиеся диаграммы сохранятся блоками кода.
Что делать при ошибке 99991672 или 99991679?
Код 99991672 означает, что у приложения не включено разрешение: включите его на открытой платформе по ссылке из сообщения и опубликуйте версию. Код 99991679 означает, что пользователь не дал нужный scope: повторите `feishu-cli auth login --scope "<scope>"`.
Как не отправить лишнего?
Операции записи принимают `--dry-run` и показывают действие без выполнения. Отправка сообщений поддерживает ключи идемпотентности против дублей.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыLark CLI
lark-cli
Официальный CLI Lark и Feishu со скиллами для агентов: сообщения, документы, таблицы, календарь, почта и задачи из терминала, более 200 команд
MCP-сервер для Feishu и Lark: агент читает и правит документы блоками, ведет задачи и ищет коллег, а набор инструментов доступен и как CLI
Плагин OpenClaw для Feishu и Lark: бот в личных и групповых чатах, работа с документами, вики, диском, задачами и таблицами
Официальный плагин Lark и Feishu для OpenClaw: чат, документы, таблицы, календарь и задачи компании из диалога с агентом
Консоль и скилл для Meegle (Lark Project): агент ведет рабочие элементы, узлы процесса, подзадачи и сроки без браузера
Консоль и TUI сервиса HEY: почта, календарь и контакты в терминале для человека и для агента
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| feishu-cli (эта карточка) | нет | 1 438 | ||
| Lark CLI | да | 18 007 | официальный CLI Lark и Feishu от вендора; feishu-cli ведет независимый автор, у него 503 команды и двусторонняя конвертация Markdown | |
| Feishu-MCP | нет | API-ключ | 746 | MCP-сервер, где агент правит документы блоками; feishu-cli работает командами и скиллами и покрывает почту, календарь и согласования |
| OpenClaw Lark/Feishu Plugin | да | 2 383 | плагин Lark и Feishu для OpenClaw; feishu-cli ставит скиллы в Claude Code |
Коротко о README
Автор объясняет, что проект рассчитан в первую очередь на агентов, хотя людям команды тоже доступны. Раздел быстрого старта состоит из трех шагов: установка, создание приложения и первый импорт документа. Затем идут справочник команд, список разрешений и ответы на частые ошибки.