en

Installation

Install PCPM on Windows, macOS, and Linux.

PCPM is distributed as a .NET global tool. It runs on .NET 10 SDK and works on Windows, macOS, and Linux.

Once PCPM is published to nuget.org, the install is a one-liner:

dotnet tool install --global pcpm

Make sure ~/.dotnet/tools (on Linux/macOS) or %USERPROFILE%\.dotnet\tools (on Windows) is on your PATH. Most .NET SDK installations do this for you on first use, but if not:

# bash / zsh
echo 'export PATH="$PATH:$HOME/.dotnet/tools"' >> ~/.bashrc

# PowerShell
[Environment]::SetEnvironmentVariable("Path", "$env:Path;$env:USERPROFILE\.dotnet\tools", "User")

Build from source

If you want the bleeding edge, or if you want to contribute, clone the repository and build:

git clone https://github.com/cristiancastineiras/pcpm
cd pcpm
dotnet build pcpm.slnx

The compiled binary is at src/pcpm.Cli/bin/Release/net10.0/pcpm.dll. To use it as if it were installed:

# From the repo root
dotnet run --project src/pcpm.Cli -- init

Or, register it as a local tool in your solution:

# Inside your .NET project
dotnet new tool-manifest   # creates .config/dotnet-tools.json (one-time)
dotnet tool install --local pcpm --add-source ../pcpm/src/pcpm.Cli/bin/Release

Verifying the install

pcpm --version

If you see a version number, you’re good.

Requirements

RequirementMinimumNotes
.NET SDK10.0.202Pin via global.json if you can
NuGet feednuget.orgOr your own NuGet v3 feed
Disk~50 MBJust for the binary and its deps
OSWindows / macOS / LinuxAll three are tier-1

Updating

dotnet tool update --global pcpm

PCPM checks for updates on pcpm install (off by default; opt in via pcpm.json). To disable, set:

{
  "updateCheck": false
}

Uninstalling

dotnet tool uninstall --global pcpm

This does not remove the global content-addressable store (%LOCALAPPDATA%\pcpm\store on Windows, ~/.local/share/pcpm/store on Linux/macOS). Use pcpm store path to find it, then delete the directory if you want a clean slate.

Next steps

Edit this page on GitHub