Hono CLI
The hono command searches framework docs, sends requests to an app without starting a server and builds a slimmer bundle.
- 367 ★ on the repository
- Last commit
Minimal access
Why this level
- Reads documentation over the network and runs app code from the file you point it at.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/hono-cliDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- Reads documentation over the network and runs app code from the file you point it at.
This is third-party code. Review the repository files before installing.
What it does
Hono CLI installs the `hono` command with five subcommands. `docs` prints Hono documentation in the terminal and `search` queries it through Algolia, returning JSON by default. `request` calls `app.request()` on an application and returns status, headers and body without starting a server. `serve` runs a local server with TypeScript and JSX support, while `optimize` bundles the app and strips unused APIs: request body readers when only GET is used, spare response helpers on Context, and the `route`, `mount` and `fire` methods. For AI agents the README includes a ready block for `CLAUDE.md`: the agent searches the docs, reads a page and checks its own code with a request.
Who it is for. Hono developers building an app with Claude Code or Cursor who want the agent to check current documentation.
Good fit when
- An agent is picking Hono middleware and needs a current documentation page.
- A route handler has to be checked with a request, without starting a server.
- A Hono bundle for an edge platform should shrink without manual edits.
- Documentation search results are piped onward into `jq`.
Not a fit when
- The project is not written in Hono.
- A scaffold for a new project is needed: there is no `create-*` command here.
- Documentation must be readable offline, since search goes over the network.
Example request
Find how to enable CORS in the Hono docs and check the `/api/users` route with a request, without starting a server.Limitations
Documentation search goes through Algolia and needs a network. The `optimize` command rewrites built code, so run the app tests on its output. The agent gets no instructions automatically: the README block for `CLAUDE.md` is added to the project by hand. GitHub shows no license file, while the README names MIT. `hono request` returns a single JSON object, so streamed responses cannot be checked this way. `serve` and `request` need an app entry file; by default the commands look for `src/index.ts`.
How to disable. Remove the package with `npm uninstall -g @hono/cli` and delete the `hono` block from `CLAUDE.md`.
FAQ
How do I connect Hono CLI to Claude Code?
Install the package globally and add the block from the Tips section of the README to `CLAUDE.md`. It lists `hono docs`, `hono search` and `hono request` and sets the order: search, read, test.
What does `hono request` return?
JSON with the response status, body and headers. The `-P`, `-X`, `-d` and `-H` flags set path, method, body and headers.
Which port does `hono serve` use?
7070 by default, changed with `-p`. Without an entry file the command starts an empty app.
What does `hono optimize` do?
It bundles the app and strips unused APIs: request body readers when only GET is used, spare response helpers on Context and the `route`, `mount` and `fire` methods. Individual passes are disabled with `--no-*` flags.
How do I pass search results to `hono docs`?
Search prints JSON, so the commands are chained with `jq`: `hono search "middleware" | jq '.results[0].path' | hono docs`.
Discussion
No questions or reviews yet.
Related
CLI toolsThree Hono skills give an agent the framework API reference and let it check routes through the Hono CLI without a server
The official Algolia CLI: indices, records, API keys and synonyms from the terminal, with a JSON command schema for agents
A Symfony plugin for Claude Code: 44 skills, 7 subagents and 13 commands for API Platform, Doctrine, TDD, Messenger and DDD
Anthropic Laravel puts the Claude API behind a Laravel facade and ships a Laravel Boost skill so agents write code for the package
Apollo's MCP server: turns chosen GraphQL operations into tools the agent uses to work with your API
An MCP server for Lunora apps: the agent reads functions, tables, logs and errors of a deployed backend and runs queries.
README in short
Hono CLI is meant for humans and AI working with Hono. It does not scaffold projects or wrap Vite. Install it with `npm install -g @hono/cli`, then use the `docs`, `search`, `request`, `serve` and `optimize` subcommands.