# Install pieces-cli with Homebrew, winget

Command-line tool for Pieces.app. Version 1.20.1 via Homebrew; verified 2026-06-21. Also installable with winget: winget install --id MeshIntelligentTechnologies.PiecesCLI -e.

## Install

```sh
sudo av install brew:pieces-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install pieces-cli
```

  Evidence: local Homebrew formula metadata

### Windows

- winget (92%):

```sh
winget install --id MeshIntelligentTechnologies.PiecesCLI -e
```

  Evidence: Windows Package Manager source index: MeshIntelligentTechnologies.PiecesCLI from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:pieces-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/pieces-cli>
- **Version:** 1.20.1
- **Source summary:** Command-line tool for Pieces.app
- **Homepage:** <https://docs.pieces.app/products/cli>
- **Repository:** <https://github.com/pieces-app/cli-agent>
- **Upstream docs:** <https://docs.pieces.app/products/cli>
- **License:** MIT
- **Source archive:** <https://files.pythonhosted.org/packages/d4/28/e5c3d511e6a81b06f0c293909dfb138fd10d28979968e4a4ad12cf671f73/pieces_cli-1.20.1.tar.gz>
- **Last updated:** 2026-06-21T11:10:23Z
- **Generated:** 2026-08-04T22:13:35+00:00

## Executables

- pieces (cli)
- pieces (alias)

## Dependencies

- certifi
- libyaml
- pydantic
- python@3.14
- rpds-py

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-08-04
- Package-manager version: 1.20.1
- Package-manager updated: 2026-06-21
- Local data: ok
- Upstream repository: https://docs.pieces.app/products/cli
- info: Release/tag comparison is only available for GitHub repositories.

## Security Notes

No matching local secret-handling manifest was found for pieces-cli. Package metadata is still published here so future coverage has a stable package URL.


## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** pieces-cli
- **Version Scheme:** 0
- **Revision:** 7
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- winget - MeshIntelligentTechnologies.PiecesCLI: normalized package name match | Windows Package Manager source index: MeshIntelligentTechnologies.PiecesCLI from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [MCP tool packages](https://pkg.so/mcp-tools/) - Mentions MCP or Model Context Protocol.
- [AI and agent packages](https://pkg.so/ai-agent-tools/) - Matched AI model, agent, coding-agent, orchestration, or MCP metadata.
- [Terminal utility packages](https://pkg.so/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://pkg.so/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [python@3.14](https://pkg.so/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [gemini-cli](https://pkg.so/brew/gemini-cli/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [opencode](https://pkg.so/brew/opencode/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [rtk](https://pkg.so/brew/rtk/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [qwen-code](https://pkg.so/brew/qwen-code/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [pi-coding-agent](https://pkg.so/brew/pi-coding-agent/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [worktrunk](https://pkg.so/brew/worktrunk/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [beads](https://pkg.so/brew/beads/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [specify](https://pkg.so/brew/specify/) - Shares pkgdb curated category or tags: ai, cli, coding-agents.
- [kimi-cli](https://pkg.so/brew/kimi-cli/) - Both packages touch the same language runtime or ecosystem. Shared terms: agents, ai, certifi, cli, coding.
- [mistral-vibe](https://pkg.so/brew/mistral-vibe/) - Both packages touch the same language runtime or ecosystem. Shared terms: agents, ai, certifi, cli, coding.
- [rawdog](https://pkg.so/brew/rawdog/) - Both packages touch the same language runtime or ecosystem. Shared terms: agents, ai, certifi, cli, coding.

## Combined YAML source

View the package source record on GitHub. [combined/pieces-cli.yml](https://github.com/mxcl/pkgdb/blob/main/combined/pieces-cli.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph