# Cecil B Menswear CLI (cecilb)

`cecilb` is the official command-line tool for the [Cecil B Menswear API](https://api.cecilbmenswear.com/docs). Search the catalog, read prices and availability, list collections, and get store hours and policies from a terminal, a script, or a coding agent. It's read-only and needs no API key.

- Package: `cecilb-cli` 1.0.0, command `cecilb`
- Requires: Node.js 18 or newer, no dependencies
- Tarball: https://api.cecilbmenswear.com/cli/cecilb-cli.tgz (versioned: https://api.cecilbmenswear.com/cli/cecilb-cli-1.0.0.tgz)
- Integrity: `sha512-TJeiMSjXnJGdKIz/YoCY6N8zuHGdqmILTMkYg4MpfflgSQO6xu4pUpxSpZoMHb3MvSNrldbAvrE7jFvX5JrTXw==`
- This page as Markdown: https://api.cecilbmenswear.com/cli.md

## Install

```bash
npm install -g https://api.cecilbmenswear.com/cli/cecilb-cli.tgz
cecilb --help
```

Run it once without installing:

```bash
npx -y https://api.cecilbmenswear.com/cli/cecilb-cli.tgz search navy suit
```

## Commands

| Command | What it does |
|---|---|
| `cecilb search <words...> [--limit N]` | Search products (up to 10 results) |
| `cecilb products [--page N] [--limit N]` | List the catalog, newest first |
| `cecilb product <handle>` | One product with variants, prices and availability |
| `cecilb collections [--page N] [--limit N]` | List collections |
| `cecilb collection <handle> [--page N] [--limit N]` | Products in one collection |
| `cecilb store` | Address, phone, email and opening hours |
| `cecilb policies` | List store policies |
| `cecilb policy <refund, shipping, privacy, terms or contact>` | Full policy text (refund is the exchange policy) |
| `cecilb mcp-config` | Print an MCP client config for the [Cecil B Menswear MCP Server](https://api.cecilbmenswear.com/mcp) |

Add `--json` to any command for the raw API JSON:

```bash
cecilb search "dress shoes" --json
cecilb product vitali-blue-seersucker-two-piece-suit --json
cecilb store
```

## Prices

"price pending" means the item has no online price yet. It is not free; call the store at (313) 336-7294.

## Exit codes

Exit code 0 means success, 1 means an API or network error (the API's `detail` and `hint` are printed), and 2 means a usage error. Use `--base-url` or the `CECILB_API_URL` environment variable to point it at another base URL.

## Related

- [Cecil B Menswear API documentation](https://api.cecilbmenswear.com/docs)
- [Cecil B Menswear MCP Server](https://api.cecilbmenswear.com/mcp)
- [Developer portal](https://cecilbmenswear.com/developers)
- Support: support@cecilbmenswear.com or (313) 336-7294
