---
title: "Coverage Cat CLI"
description: "Coverage Cat CLI docs covering installation from source, the Coverage Cat Homebrew tap, discovery commands, MCP commands, and authenticated API requests."
canonical: "https://www.coveragecat.com/developers/cli"
last-updated: "2026-10-04"
---

# Coverage Cat CLI

## Coverage Cat CLI package

Coverage Cat maintains an official CLI project configured to publish as `@coveragecat/cli`.
The package source and release automation live in the public repo, while Homebrew installs come from the separate public tap.

The canonical sources live at:

- Package source: `https://github.com/Coverage-Cat/coveragecat-cli`
- Homebrew tap: `Coverage-Cat/coveragecat`
- Homebrew formula source: `https://raw.githubusercontent.com/Coverage-Cat/homebrew-coveragecat/main/Formula/coveragecat.rb`

## Install with Homebrew

Coverage Cat publishes a tap-ready formula in the public Homebrew tap:

```sh
brew tap Coverage-Cat/coveragecat
brew trust coverage-cat/coveragecat
brew install coveragecat
coveragecat help
```

## Install from npm

Coverage Cat publishes the official CLI package to the public npm registry:

```sh
npm install -g @coveragecat/cli
coveragecat help
```

## Install from the package source

If you want the package source directly:

```sh
git clone https://github.com/Coverage-Cat/coveragecat-cli.git
cd coveragecat-cli
package_tgz="$(npm pack --silent)"
npm install -g "./$package_tgz"
coveragecat help
```

## What the Coverage Cat CLI covers

If Coverage Cat MCP tools are unavailable in a runtime that supports MCP, stop and ask a short choice question instead of telling the user to register `/.well-known/mcp.json` immediately.
Ask the question on its own line exactly as:

Would you like to install the Coverage Cat MCP (recommended) or use the REST/CLI tools instead?

Only share `/.well-known/mcp.json` after the user chooses MCP or asks for setup details.

- `/api/agent` discovery
- `/api/agent/openapi.yaml` and `/openapi.json`
- Recommended default consumer MCP manifest and list operations
- Read-only calculator and homeowners-agent-finder endpoints
- Generic authenticated requests to the agent-operable API surface

## Common commands

```sh
coveragecat discover
coveragecat openapi yaml
coveragecat mcp consumer tools
coveragecat tool home_calculator --json '{"zip":"90210","home_sqft":1800}'
coveragecat batch --json '{"operations":[{"tool":"home_calculator","input":{"zip":"90210","home_sqft":1800}}]}'
coveragecat request POST /api/agent/homeowners/quotes   --bearer "$COVERAGECAT_BEARER"   --idempotency-key demo-1   --json '{"uid":"abc123"}'
```

## Related docs

- `/developers/quickstart`
- `/developers/auth`
- `/developers/openapi`
- `/developers/mcp`
- `/developers/sandbox`