Referência do @igrp/cli — comandos de ambiente (doctor, studio), criação de projetos, geração de artefactos, skills, bundles e migrações do template.
@igrp/cli (binário igrp) é a linha de comandos oficial do ecossistema iGRP. Esta página refere a versão 1.7.9. Cobre estas áreas:
| Área | Comandos | Documentação |
|---|---|---|
| Ambiente e Studio | doctor, studio, studio-check-update, studio-install, new | esta página |
| Geração de artefactos | generate (alias gen) | Generate |
| Gestão de skills | skill (alias sk) | Skills |
| Bundles (páginas, metadata, dependências) | bundle (alias b) | Bundles |
| Atualizar o template de uma app | migrate | Migrações do template |
Instalação
O CLI instala-se no primeiro arranque do Studio (botão Install CLI) ou no terminal:
npm install -g @igrp/cli --registry=https://sonatype.nosi.cv/repository/npm-group/Requer Node.js 22.12+. Os pacotes iGRP vivem no registry da NOSi, não no npm público — por isso o --registry é obrigatório (ou configurado uma vez no .npmrc). Confirma a versão com igrp --version.
Ajuda de cada comando
igrp <comando> --help (ou igrp help <comando>) mostra as opções; por exemplo igrp generate page --help. As opções globais vêm antes do comando: igrp -v funciona, igrp skill -v dá erro.
Ambiente e diagnóstico
igrp doctor
Executa um diagnóstico do ambiente local, em três grupos (Frontend, Backend e Infraestrutura): Node.js, npm, pnpm, yarn, Java, Docker e Git. Corre isto sempre que algo "não faz sentido" antes de reportar um bug.
igrp doctorIGRP Studio Desktop
igrp studio # abre o Studio na pasta atual
igrp studio . # equivalente
igrp studio /caminho/projecto
igrp studio-check-update # verifica se há uma versão do Studio compatível
igrp studio-install # descarrega e instala essa versãoigrp studio-check-update resolve a versão certa por plataforma (macOS/Windows/Linux) e canal de atualização — a mesma lógica que o próprio Studio usa para se auto-atualizar.
Criar um projeto novo
igrp new meu-projectoigrp new não gera código: faz duas perguntas e cria a pasta meu-projecto/ apenas com um igrp.project.json.
| Pergunta | Opções |
|---|---|
| Tipo de projeto | web (IGRP Web / Java), springboot-api, nextjs |
| Group ID | Texto; default cv.nosi |
{
"name": "meu-projecto",
"type": "nextjs",
"groupId": "cv.nosi",
"createdAt": "2026-10-26T15:00:00.000Z"
}No fim sugere cd meu-projecto e igrp studio .. O código do projeto é criado no Studio (Novo Projeto). O type serve ao igrp skill init para escolher as skills recomendadas:
type | Skills instaladas por igrp skill init |
|---|---|
nextjs | igrp-studio-metadata |
springboot-api | igrp-spring-backend (meta: instala as skills Spring Boot) |
web | igrp-studio-metadata e igrp-spring-backend |
Num projeto criado pelo Studio não precisas de igrp new: o skill init lê o tipo de .igrpstudio/baseApp.json.
Versão
igrp new funciona a partir da 1.7.9 (nas 1.7.0–1.7.8 falhava antes da primeira pergunta).
Atualizar o template da app
igrp migrate status # migrações aplicadas e pendentes
igrp migrate plan # o que vai mudar
igrp migrate apply # aplica
igrp migrate@0.2.0-beta.16 status # fixa a versão do migratorCorre o @igrp/template-migrator (via pnpm dlx ou npx) na pasta da app, sempre na versão que o registry indica. Ver Migrações do template.
A seguir
- Generate — gerar páginas, componentes e passos de processo a partir de manifestos JSON, o mesmo pipeline que o Studio usa ao gravar no Page Builder.
- Skills — instalar cápsulas de conhecimento para agentes IA (Claude Code, Cursor, Studio Prototype builder) num projeto.
- Bundles — instalar pacotes declarativos (runtime de processos, templates de formulário, migrações) num projeto.
Última atualização: