BCD

Command-line tools › P

Run pieces-cli from ChatGPT or Claude

Command-line tool for Pieces.app. With BCD, ChatGPT, Claude and other AI apps can install and run pieces-cli on your own computer and read what it prints.

Works on

About pieces-cli

Version
1.20.1
License
MIT
Installs (last 365 days)
982 · #2,692 in Homebrew
Homepage
docs.pieces.app/products/cli
Install
brew install pieces-cli

Try asking

“Install pieces-cli with Homebrew and show me its version”
“Read pieces-cli --help and give me three useful examples for my files”
“Update pieces-cli and tell me what changed”

Depends on

certifi · cryptography · libyaml · pydantic · python@3.15 · rpds-py

Questions

Can ChatGPT run pieces-cli on my computer?
Yes. With BCD on your Mac or Linux computer and command permission turned on for it, ChatGPT runs pieces-cli there and reads the output. Claude and other apps with MCP connectors can too.

Do I need to install pieces-cli first?
No. If Homebrew is installed, the AI can run brew install pieces-cli for you.

Is it safe?
A new computer starts read-only: running commands is turned on per computer, and BCD reaches only the folders you allow.

Try it on your computer

BCD connects ChatGPT, Claude and other AI apps to your own Mac, Windows or Linux computer. One computer is free, with 20,000 tool calls a month and no card.

Program data from Homebrew, updated 2026-11-11. Installs are Homebrew's installs on request over the last 365 days.