Visión general del CLI

PCPM expone un pequeño conjunto de verbos. Cada uno tiene un trabajo enfocado; las descripciones aquí son resúmenes de un párrafo, con todos los detalles en la página dedicada.

Ciclo de vida del workspace

• pcpm init — Inicializa un workspace (pcpm.json, Directory.Packages.props).
• pcpm convert — Migra una solución existente (con o sin CPM) a un workspace de PCPM.

Dependencias

• pcpm add <pkg> — Añade una dependencia directa. Escribe la versión en Directory.Packages.props, añade <PackageReference /> a uno o más .csproj, y (por defecto) ejecuta pcpm install.
• pcpm install — Resuelve el grafo transitivo, materializa paquetes en el store, hace hardlink a ~/.nuget/packages, y ejecuta dotnet restore.
• pcpm remove <pkg> — Elimina una dependencia directa. Inversa de pcpm add.
• pcpm list — Imprime pcpm.lock como una tabla de Spectre.Console.
• pcpm why <pkg> — Muestra las cadenas de dependientes que trajeron <pkg> al lockfile.

Mantenimiento

• pcpm outdated — Consulta el feed por versiones más nuevas, informa del tipo de bump (major / minor / patch).
• pcpm audit — Escanea el grafo resuelto contra avisos de vulnerabilidades conocidos.
• pcpm doctor — Diagnostica problemas comunes del entorno — integridad del store, detección del SDK de dotnet, accesibilidad del feed.

Store

• pcpm store status — Uso de disco del almacén global direccionable por contenido.
• pcpm store path — Imprime la ruta del store.
• pcpm store prune (reservado para una versión futura) — suelta los hashes que no estén referenciados por ningún lockfile.

CI

• pcpm ci — Instalación estricta y fail-fast — rechaza si pcpm.lock está desactualizado o ausente.

Flags comunes

La mayoría de comandos aceptan un pequeño conjunto de flags:

Flag	Efecto
--cwd <path>	Ejecuta como si pcpm se hubiera invocado desde <path>.
--config <path>	Usa un fichero pcpm.json diferente.
--quiet / -q	Suprime la salida que no sea de error.
--verbose / -v	Imprime cada decisión del resolver.
--no-color	Desactiva el color ANSI.
--help / -h	Muestra la ayuda específica del comando.

Convenciones

• <pkg> es un marcador de posición para un id de paquete (p. ej. Serilog).
• <version> es un marcador de posición para un rango de versión, en la misma sintaxis que <PackageReference /> en CPM. P. ej. 3.1.1, [3.0.0, 4.0.0), 3.0.*.
• Los comandos son case-insensitive en su primera palabra (PCPM init y pcpm init son lo mismo).
• Los flags se pueden combinar tras un único --. P. ej. pcpm add Serilog --version 3.1.1 --no-install.

Códigos de salida

PCPM usa un pequeño conjunto de códigos de salida:

Código	Significado
0	Éxito.
1	Error de resolución o instalación.
2	Argumentos o configuración inválidos.
3	Error de red (feed inaccesible).
4	Error de validación del lockfile (usado por pcpm ci).
64	Error interno (por favor abre un issue).

dotnet run los propaga. Los scripts de CI pueden confiar en ellos.