oro new

Visão geral

Cria um projeto a partir de uma recipe — oficial (--stack) ou customizada (--recipe).

oro new meu-app --stack fastify-next --yes

Flags

Flag	Default	Descrição
--stack	—	Recipe oficial: dotnet, dotnet-next, rails, fastify-next
--recipe	—	Caminho para recipe customizada (alternativa ao --stack)
--set key=value	—	Define variável da recipe (repetível)
--yes	false	Modo não interativo (só flags + defaults)
--dry-run	false	Mostra o plano sem executar
--repository	local	Provider Git: local, github, azure-devops
--pipeline	derivado	CI: none, github-actions, azure-pipelines
--ai	opencode	Destino de skills/agents: opencode, cursor, claude-code, codex, copilot
--visibility	private	Visibilidade no GitHub: private, public
--remote	—	URL explícita do remote Git
--organization	—	URL da org Azure DevOps
--azure-project	—	Nome do projeto Azure DevOps

Sem --yes, variáveis sem default são perguntadas no terminal (wizard interativo).

Exemplos

# Monorepo TS com variáveis explícitas
oro new loja --stack fastify-next --yes \
  --set database=postgres --set docker=true

# GitHub + GitHub Actions
oro new api --stack dotnet --yes \
  --repository github --visibility private

# Azure DevOps + Azure Pipelines
oro new portal --stack dotnet-next --yes \
  --repository azure-devops \
  --organization https://dev.azure.com/minha-org \
  --azure-project MeuProjeto

# Só scaffold local, sem remote nem CI
oro new app --stack rails --yes --repository local --pipeline none

Comportamento importante

• --dry-run — renderiza o plano (scaffold, skills, agents, pipeline, installers) sem criar arquivos nem rodar comandos externos.
• Falhas recuperáveis — erros em remote Git, pipeline ou installers externos não apagam o projeto local; o manifest é preservado para retry.
• Requirements — oro new valida ferramentas exigidas pela recipe (ex.: node, pnpm, dotnet, git); veja oro doctor.