Name: PCPM
Author: PCPM

pcpm add es el comando que usarás más a menudo. Declara una dependencia directa en tu workspace.

pcpm add <package>[@<version>] [options]

Qué hace

Resuelve una versión para <package>. Por defecto, la última estable en el feed. Sobrescribe con <package>@<version>, --version <v>, o --version-range <r>.
Escribe la versión en Directory.Packages.props como entrada <PackageVersion />.
Añade una entrada <PackageReference Include="…" /> a uno o más ficheros .csproj.
Ejecuta pcpm install para materializar el cambio en el store (salta con --no-install).

Opciones

Flag	Efecto
`<package>`	El id del paquete, p. ej. `Serilog`.
`<package>@<version>`	Fija una versión específica inline.
`--version <v>`	Fija una versión específica.
`--version-range <r>`	Fija un rango de versiones (p. ej. `3.0.*`, `[3.0, 4.0)`).
`--project <path>`	Añade a un `.csproj` específico. Repetible.
`--all-projects`	Añade a cada proyecto del workspace (por defecto).
`--no-install`	Salta el `pcpm install` implícito.
`--prerelease`	Incluye versiones pre-release en la resolución.
`--source <url>`	Usa un feed específico para esta resolución.

Ejemplos

# Añade la última estable de Serilog
pcpm add Serilog

# Fija una versión específica
pcpm add Serilog@3.1.1

# Añade a un solo proyecto
pcpm add Serilog --project src/Api/Api.csproj

# Añade a un subconjunto de proyectos
pcpm add Microsoft.Extensions.Hosting \
  --project src/Api/Api.csproj \
  --project src/Worker/Worker.csproj

# Fija un rango de versiones
pcpm add Newtonsoft.Json --version-range "13.0.*"

# Añade desde un feed privado
pcpm add Contoso.Internal --source https://pkgs.contoso.com/v3/index.json

Install implícito

Por defecto, pcpm add termina con pcpm install para que la nueva dependencia esté en disco y lista para usar en cuanto vuelve el prompt. En un monorepo, esto significa que el lockfile también se actualiza y se commitea. El install implícito es una funcionalidad, no un bug — atrapa errores tipográficos en el id del paquete de inmediato.

Si quieres añadir muchos paquetes de una vez e instalar solo al final, encadénalos:

pcpm add Serilog --no-install
pcpm add Microsoft.Extensions.Hosting --no-install
pcpm add Serilog.Sinks.Console --no-install
pcpm install

Véase también

pcpm remove — operación inversa.
pcpm install — el comando bestia.
Configuración — para feeds privados.