CLI

The consumer CLI for local tool discovery. All commands output JSON by default for easy piping.

Install

No global install needed. Run directly with npx, or install globally with npm.

Run with npx

npx which-cli

Or install globally

npm install -g which-cli

Global options

These flags work with every command.

--jsonJSON output (default)
--rawUnformatted JSON, no color
--prettyHuman-readable table output

Commands

search

Search tools by name, description, or capability. Returns matching tools ranked by relevance.

npx which-cli search kubernetes # Returns matching tools with descriptions and capabilities

info

Get full metadata for a specific tool, including auth, flags, output formats, and agent notes.

npx which-cli info kubectl # Full metadata: auth, flags, output formats, agent notes

list

List all tools in the catalog with token estimates for context budgeting.

npx which-cli list # All tools with token estimates for context budgeting

check

Check which tools are available on the current system.

npx which-cli check # Reports installed/missing status for each tool

index

Dump the full catalog index. Useful for piping into other tools or loading into an agent context.

npx which-cli index # Full catalog index as JSON

capabilities

List the controlled capability vocabulary with tool counts per capability.

npx which-cli capabilities # All capabilities with tool counts

categories

List all categories with tool counts.

npx which-cli categories # All categories with tool counts