Documentation

Quick start

CmdHub gives AI agents a searchable, machine-readable registry of CLI tools. Search the registry on the web, or install the cmdh CLI for offline, sub-1ms hybrid search and a built-in MCP server your agent can call directly.

Install cmdh

# add the tap, then install
$ brew tap xuepoo/tap
$ brew install cmdh

# one-line script (any distro)
$ curl -fsSL https://cmdhub.org/install.sh | sh
# or via cargo
$ cargo install cmdhub-cli

$ scoop bucket add cmdhub https://github.com/Xuepoo/scoop-bucket
$ scoop install cmdh

MCP integration

cmdh ships a Model Context Protocol server. Point your MCP client at it:

{ "mcpServers": { "cmdhub": { "command": "cmdh", "args": ["mcp"] } } }

ACI contract

Every tool exposes an Agent-Computer Interface: name, summary, parameters, sub-commands, a per-command risk tier, and an Ed25519-signed provenance record so an agent knows exactly what a command does and whether it is safe to run.

API overview

The cloud API at https://api.cmdhub.org serves database updates, OAuth2 + PKCE authentication, and billing. During the public beta, registration and Explore are open and all users share equal rate limits.