# Install icp-cli with Homebrew

Development tool for building and deploying canisters on ICP. Version 1.0.2 via Homebrew; verified 2026-06-26.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install icp-cli
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:icp-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/icp-cli>
- **Version:** 1.0.2
- **Source summary:** Development tool for building and deploying canisters on ICP
- **Homepage:** <https://dfinity.github.io/icp-cli/>
- **Repository:** <https://github.com/dfinity/icp-cli>
- **Upstream docs:** <https://cli.internetcomputer.org/>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/dfinity/icp-cli/archive/refs/tags/v1.0.2.tar.gz>
- **Last updated:** 2026-06-26T19:14:02Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- icp (cli)
- icp (alias)

## Dependencies

- ic-wasm
- openssl@4

## Build dependencies

- rust

## 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-07-08
- Package-manager version: 1.0.2
- Package-manager updated: 2026-06-26
- Local data: ok
- Upstream repository: https://github.com/dfinity/icp-cli
- Upstream latest detected: v1.0.2 (current)
## Project history and usage

icp-cli is DFINITY's command-line tool for building and deploying applications, called canisters, on the Internet Computer.

### Project history

DFINITY announced the public icp-cli repository on 2025-10-31, describing the tool as under active development and intended to eventually replace dfx while coexisting with it for some time because the tools work differently.

The first official release announcement for v0.1.0 appeared on 2026-02-04 after beta testing and community feedback. By the v1.0.0 GitHub release on 2026-06-15, the project distributed signed release artifacts for macOS, Linux, and Windows.

### Adoption history

The README and installation guide put npm at the center of the quick-start path, installing @icp-sdk/icp-cli together with @icp-sdk/ic-wasm. The npm registry records @icp-sdk/icp-cli creation on 2026-01-30.

Homebrew packaging followed as another supported route for macOS and Linux. The first official release announcement explicitly asked users to help the repositories reach Homebrew's star threshold, and the formula later packages icp-cli with ic-wasm and OpenSSL.

### How it is used

icp-cli is used to initialize, build, deploy, and operate Internet Computer canisters. Its docs pair the core CLI with ic-wasm for WebAssembly optimization and with Motoko or Rust toolchains depending on the project.

The configuration surface centers on icp.yaml, matching the curated config-file location for both Unix-like systems and Windows.

### Why package nerds care

icp-cli is significant because it represents a blockchain/platform SDK moving from an older established command, dfx, toward a new command named icp with modern packaging through npm, shell installers, release artifacts, and Homebrew.

It is also a useful case study in packaging a Rust-based developer tool that depends on a companion WebAssembly optimizer and supports multiple installation ecosystems from the beginning.

### Timeline

- 2025-10-31: DFINITY announces that the icp-cli repository is public.
- 2026-01-30: @icp-sdk/icp-cli package is created on npm.
- 2026-02-04: icp-cli v0.1.0 is announced as the first official release.
- 2026-06-15: GitHub release v1.0.0 publishes multi-platform install artifacts.
- 2026: Homebrew formula packages icp-cli with ic-wasm and OpenSSL.

### Related projects

- Related projects include dfx, ic-wasm, icp-cli-recipes, Motoko tooling, Mops, Rust canister workflows, Candid tooling, and the wider Internet Computer SDK documentation.

### Sources

- DFINITY forum announcements document repository publication, first official release, beta feedback, npm installation, Homebrew motivation, and the dfx relationship.
- The GitHub README and docs describe purpose, installation, dfx migration, examples, and documentation structure.
- npm, GitHub releases, and Homebrew metadata document package publication and distribution channels.


## Security Notes

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



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: icp.yaml
- Windows: icp.yaml
## Source Database Details

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


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched curated package taxonomy and local package facts.
- [ic-wasm](https://www.automicvault.com/pkg/brew/ic-wasm/) - Runtime dependency declared by Homebrew.
- [openssl@4](https://www.automicvault.com/pkg/brew/openssl-4/) - Runtime dependency declared by Homebrew.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [urweb](https://www.automicvault.com/pkg/brew/urweb/) - Local package facts share a topical domain. Shared terms: development, openssl, openssl-4.
- [aircrack-ng](https://www.automicvault.com/pkg/brew/aircrack-ng/) - Local package facts share a topical domain. Shared terms: openssl, openssl-4.

## Combined YAML source

View the package source record on GitHub. [combined/icp-cli.yml](https://github.com/automic-vault/db/blob/main/combined/icp-cli.yml)


## Sources

- Nucleus package database
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- package relationship graph
- cross-ecosystem install command graph
