Hono CLI
Команда hono ищет по документации фреймворка, отправляет запросы в приложение без сервера и собирает облегченную сборку.
- 367 ★ репозитория
- Последний коммит
Минимальный доступ
Почему такой уровень
- Читает документацию по сети и запускает код приложения из указанного файла.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/hono-cliОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Читает документацию по сети и запускает код приложения из указанного файла.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Hono CLI ставит команду `hono` с пятью подкомандами. `docs` выводит документацию Hono прямо в терминал, `search` ищет по ней через Algolia и по умолчанию отдает JSON. `request` вызывает `app.request()` у приложения и возвращает статус, заголовки и тело, не запуская сервер. `serve` поднимает локальный сервер с поддержкой TypeScript и JSX, а `optimize` собирает бандл и вырезает неиспользуемые API: чтение тела запроса при одних GET, лишние методы ответа в Context, методы `route`, `mount` и `fire`. Для ИИ-агентов в README есть готовый блок для `CLAUDE.md`: агент ищет в документации, читает нужную страницу и проверяет свой код запросом.
Для кого. Разработчикам на Hono, которые пишут приложение вместе с Claude Code или Cursor и хотят, чтобы агент сверялся с актуальной документацией.
Подходит, если
- Агент выбирает middleware для Hono и ему нужна свежая страница документации.
- Обработчик маршрута надо проверить запросом, не поднимая сервер.
- Бандл Hono на периферийной платформе хочется уменьшить без ручной правки.
- Результаты поиска по документации передают дальше по конвейеру в `jq`.
Не подходит, если
- Проект написан не на Hono.
- Нужен каркас нового проекта: `create-*` команды тут нет.
- Документация должна читаться офлайн, поиск идет через сеть.
Пример запроса к агенту
Найди в документации Hono, как подключить CORS, и проверь маршрут `/api/users` запросом без запуска сервера.Ограничения
Поиск по документации работает через Algolia и требует сети. Команда `optimize` меняет собранный код: результат стоит прогнать через тесты приложения. Агент не получает инструкций автоматически, блок для `CLAUDE.md` из README добавляют в проект вручную. GitHub не определил лицензию, в тексте README названа MIT. Результат `hono request` приходит одним JSON, потоковые ответы так не проверить. Для `serve` и `request` нужен файл входа приложения; по умолчанию команды ищут `src/index.ts`.
Как отключить. Удалите пакет командой `npm uninstall -g @hono/cli` и уберите блок про `hono` из `CLAUDE.md`.
Частые вопросы
Как подключить Hono CLI к Claude Code?
Поставьте пакет глобально и добавьте в `CLAUDE.md` блок из раздела Tips в README. Он перечисляет `hono docs`, `hono search` и `hono request` и задает порядок: найти, прочитать, проверить.
Что вернет `hono request`?
JSON со статусом, телом и заголовками ответа. Флаги `-P`, `-X`, `-d` и `-H` задают путь, метод, тело и заголовки.
Какой порт у `hono serve`?
По умолчанию 7070, меняется флагом `-p`. Без файла входа команда запускает пустое приложение.
Что делает `hono optimize`?
Собирает бандл и вырезает неиспользуемые API: чтение тела запроса при одних GET, лишние методы ответа в Context и методы `route`, `mount`, `fire`. Отдельные оптимизации отключают флагами `--no-*`.
Как передать результаты поиска в `hono docs`?
Поиск выводит JSON, поэтому команды соединяют через `jq`: `hono search "middleware" | jq '.results[0].path' | hono docs`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыТри скилла Hono дают агенту справку по API фреймворка и проверку маршрутов через Hono CLI без запуска сервера
Официальный CLI Algolia: индексы, записи, ключи API и синонимы из терминала, схема команд в JSON для агента
Плагин Symfony для Claude Code: 44 навыка, 7 субагентов и 13 команд по API Platform, Doctrine, TDD, Messenger и DDD
Anthropic Laravel подключает Claude API к Laravel через фасад и дает скилл Laravel Boost, чтобы агент писал код под пакет
MCP-сервер Apollo: превращает заданные операции GraphQL в инструменты, через которые агент работает с вашим API
MCP-сервер для приложений на Lunora: агент читает функции, таблицы, логи и ошибки развернутого бэкенда и вызывает запросы.
Коротко о README
Hono CLI задуман для людей и ИИ, которые работают с Hono. Он не создает проекты и не оборачивает Vite. Установка одной командой `npm install -g @hono/cli`, затем подкоманды `docs`, `search`, `request`, `serve` и `optimize`.