Ir para o conteúdo

n45-ai init

Configura o N45 na pasta atual — como Project ou Workspace.

Synopsis

npx n45-ai@latest init [--kind project|workspace] [--tool claude,cursor,codex]

Pré-requisitos

  • Node.js 22 ou superior
  • Git instalado na sua máquina
  • Uma licença N45.AI ativa e um npx n45-ai@latest login prévio

Descrição

O init primeiro pergunta o que você está configurando:

  • Project — um único repositório (um app, um microsserviço, um monorepo).
  • Workspace — um grupo de repositórios, polyrepo (veja a seção Workspace).

Se a pasta já tem subpastas que são repositórios git (candidatas a membro), o init detecta um Workspace automaticamente e pula a pergunta — use --kind project pra sobrescrever.

Depois ele pergunta quais assistentes de IDE você usa (Claude Code, Cursor ou Codex) e configura:

  • Project — cria o diretório .n45/, a configuração da IDE (.claude/, .cursor/ ou .codex/) e os slash commands (/n45, /n45-feat, /n45-fix, /n45-status, /n45-run, /n45-next).
  • Workspace — cria o .n45/ de coordenação (o nome do workspace é o nome da pasta, sem pergunta), depois lista as pastas git que encontrou e oferece adicioná-las como membros, todas pré-selecionadas — é só confirmar. Cada membro é preparado automaticamente. Veja Configurar o Workspace pro fluxo completo.

O init não baixa o binário — isso acontece no primeiro uso (login, status ou um slash command), ou explicitamente via install.

Deve ser rodado da raiz do seu projeto (ou da pasta do workspace). Requer um npx n45-ai@latest login prévio — que por sua vez requer uma licença ativa.

Não-interativo

Passe flags pra pular os prompts (útil em scripts/CI):

  • --kind project|workspace — pula a pergunta Project/Workspace.
  • --tool <a,b> — as ferramentas de IDE (repetível ou separado por vírgula); pula o prompt de ferramentas.
npx n45-ai@latest init --kind workspace --tool claude,cursor

Já configurado com outra versão?

Se o projeto já tem skills do N45 e uma pasta .n45/ de uma versão diferente, o init para e pede pra você rodar o upgrade primeiro. Isso garante que o .n45/ do projeto seja migrado antes das skills serem substituídas — rodar skills novas contra um .n45/ de schema antigo corromperia o projeto. Re-rodar o init na mesma versão é seguro (ex: adicionar outra IDE).

O que ele modifica

Arquivo / pasta Ação
.n45/ Criado (um projeto ou um workspace, conforme sua escolha)
.claude/ Criado (skills + settings)
.cursor/ Criado (skills + cli.json + .cursorignore)
.codex/ Criado (skills + permissões)

Num workspace, cada membro que você adiciona também ganha o próprio .n45/ e as skills, configurados automaticamente. Suas configurações existentes são preservadas quando o N45 atualiza um arquivo compartilhado.

Exemplos

# um projeto single-repo (interativo)
cd /caminho/do/seu/projeto
npx n45-ai@latest init

# um workspace (auto-detectado se a pasta já tem repos git dentro)
cd /caminho/do/seu/workspace
npx n45-ai@latest init

Veja também