honojs/cli

何を解決するか

Hono CLI は Hono アプリケーション開発のための専用コマンドラインインターフェースを提供します。ドキュメントアクセス、サーバー管理、アプリケーション最適化を1つのツールに統合することで、開発者の体験をスムーズにし、特に人間の開発者と AI コーディングエージェントの両方にとって簡単に利用可能な出力を設計しています。

動作方法

このツールは hono コマンドを提供し、いくつかの専用サブコマンドを備えています：

• ドキュメントアクセス: docs はターミナル上で Hono のドキュメントを直接読むことを可能にし、search は Algolia によるファジー検索で関連ページを検索します（デフォルトで JSON 形式で出力され、ツールとの統合に適しています）。
• アプリケーションテスト: request はフルサーバーを起動せずに、組み込みの app.request() メソッドを使って Hono アプリに HTTP リクエストを送信できます。
• アプリケーション実行: serve は組み込みの TypeScript および JSX サポートで Hono アプリのサーバーを起動します。
• バンドル最適化: optimize はアプリケーションの使用状況に基づいて、未使用の Hono API（リクエストボディ API や特定の Context 応答ユーティリティなど）を削除することでバンドルサイズを削減します。

対象ユーザー

Hono フレームワークを使用するウェブ開発者および、ドキュメントを検索し、実装をテストするためのプログラム可能な方法を必要とする AI コーディングエージェント（例：Claude Code）。

特徴

• AI対応設計: ドキュメント検索と取得は、AI エージェントが Hono の機能を効率的に参照・実装できるように最適化されています。
• サーバーレステスト: request コマンドにより、実行中のサーバープロセスなしでアプリロジックを迅速にテストできます。
• ツリーシェイキング最適化: optimize コマンドは未使用のフレームワーク API を削除し、最終的なバンドルサイズを最小限に抑えます。
• JSON優先出力: 検索結果はデフォルトで JSON 形式で返されるため、jq などの他の CLI ツールに簡単にパイプできます。