macOS
Homebrewverified ยท 100%
brew install icp-clilocal Homebrew formula metadata
brew
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
Additional install commands
overview
Package summary
Development tool for building and deploying canisters on ICP
Project links
Commands and aliases
- icp
history
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 posture
No protected-tool coverage found yet
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.
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Installs with 2 runtime dependencies.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
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
Config paths the tool may read or write during local use.
- Unix
icp.yaml- Windows
icp.yaml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
icp | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-07-08
manager version1.0.2
manager updated2026-06-26
local dataok
upstreamcurrent
latest detectedv1.0.2
https://github.com/dfinity/icp-cli
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:icp-cli |
|---|---|
| Version | 1.0.2 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/icp-cli |
| 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 |
| Pulse | updated |
| Dependencies | ic-wasm, openssl@4 |
| Build dependencies | rust |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
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 |
|
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Nucleus package database
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment