Usando pacotes
add
genpm add @core/billing # última versão
genpm add @core/auth@^1.2 # intervalo semver
genpm add @core/db --dest packages/db
genpm add @core/billing --dry-run # mostra o plano sem escrever nadaO GenPM faz três perguntas separadas: injetar o código, adicionar servidores MCP (mostrando o comando completo) e rodar o comando do gerenciador de pacotes para as dependências npm. --yes só responde à primeira; use --mcp e --install-deps para as outras.
Se o destino existe e não está vazio, add falha com E_DEST_CONFLICT. --force move antes o conteúdo antigo para .genpm/backup/<timestamp>/.
search e info
genpm search stripe
genpm info @core/billing # manifesto, dependências, MCP, variáveis de ambiente e as regras de IA completas
genpm info @core/billing --rules # só as regraslist e remove
genpm list
genpm remove @core/authlist compara cada arquivo injetado com o SHA-256 registrado (mudanças locais). remove se recusa a apagar código que você modificou (E_DRIFT): use --keep-code para mantê-lo ou --force para apagar mesmo assim. Um pacote do qual outro depende não pode ser removido primeiro (E_REQUIRED_BY). Remover um pacote também remove seus servidores MCP e os arquivos que o GenPM criou e ficaram vazios.
outdated e audit
genpm outdated
genpm audit # adicione ao seu CI como: npx @genpm-net/cli auditaudit verifica a integridade dos arquivos, a assinatura do registry em cada entrada do lock, avisos de segurança, versões retiradas e quarentenas. Sai com código 6 se houver achados altos ou críticos.
update e diff
genpm diff @core/auth
genpm update @core/authdiff mostra o que mudou upstream desde a sua versão instalada, com os caminhos já apontando para a sua pasta (aplique com git apply --3way). update faz um merge de três vias: arquivos que você não tocou recebem a versão nova, as linhas que você mudou são mantidas e, se os dois lados mudaram as mesmas linhas, o arquivo fica com os marcadores padrão <<<<<<< e o comando sai com código 4. Um arquivo removido upstream que você modificou é mantido.
genpm diff --local também lista as suas mudanças locais; genpm update --dry-run mostra o plano sem escrever nada.
Saída JSON
Todos os comandos aceitam --json (uma linha, em inglês, sem perguntas). Sem terminal interativo, qualquer pergunta sem resposta falha com E_CONFIRM_REQUIRED (código de saída 2) e nada é escrito.
Receitas: vários pacotes de uma vez
Uma receita instala com um comando vários pacotes que funcionam juntos, com o mesmo plano e as mesmas perguntas do genpm add. As receitas curadas pelo GenPM estão em /recipes; seu time também pode manter a sua como arquivo JSON no repositório.
genpm compose --list
genpm compose saas-starter --dry-run
genpm compose ./stack.json{ "name": "my-stack", "p": ["@core/db", "@core/auth@^1.2"] }Registries privados
Times podem manter pacotes de repositórios privados em um registry privado (genpm registry create acme --owner minha-org, ou Configurações › Registries privados). Ele não existe para quem não é membro. Aponte seu scope para ele no .genpmrc e entre nele; o genpm add funciona igual. Membros leem pacotes internal; os private precisam de permissão (genpm access grant @acme/api team:minha-org/backend read). A GitHub App do GenPM precisa estar instalada na organização para o registry ler os repositórios privados.
# .genpmrc
@acme:registry=https://api.genpm.net/r/acme
# ENT-03: policy
policy=https://api.genpm.net/r/acmegenpm login --registry https://api.genpm.net/r/acme
genpm add @acme/payments