Ir para o conteúdo

Configurar o Workspace

Um workspace é uma pasta com os repositórios dos seus serviços dentro (ou ao lado). Você cria o workspace uma vez e registra cada repositório como membro.

Comandos no Codex

Os comandos abaixo aparecem com / (Claude Code e Cursor). No Codex, troque o prefixo por $ — ex.: /n45 → $n45.

Criar o workspace

Na pasta que contém (ou vai conter) os repositórios, rode:

npx n45-ai@latest init
  • Se a pasta já tem subpastas que são repositórios git, o N45 detecta o workspace automaticamente e segue direto para o setup de workspace.
  • Se não, ele pergunta Project ou Workspace? — escolha Workspace.

O nome do workspace é o nome da pasta (sem pergunta). Em seguida o N45 pergunta quais ferramentas de IA você usa (Claude Code, Cursor, Codex) e instala as skills.

Adicionar os membros

No fim do init, o N45 lista as pastas git que encontrou e oferece adicioná-las como membros — todas já pré-selecionadas. Basta confirmar (ou desmarcar as que não quiser).

Você também adiciona membros a qualquer momento:

# adicionar um repositório existente (caminho local)
npx n45-ai@latest workspace add ./frontend

# clonar e adicionar de uma URL git
npx n45-ai@latest workspace add git@github.com:acme/api.git

# adotar de uma vez todas as pastas git ainda não registradas
npx n45-ai@latest workspace add --all

Ao adicionar um membro, o N45 prepara o repositório automaticamente: cria o .n45/ dele e instala as skills das ferramentas de IA que o workspace usa. O membro fica pronto sem init manual.

O membro precisa ser um repositório git

workspace add <caminho> exige que o caminho seja um repositório git de verdade. Se ainda não for, rode git init nele antes (ou aponte para um repositório existente).

Gerenciar os membros

# listar os membros
npx n45-ai@latest workspace list

# desregistrar um membro (não apaga o repositório)
npx n45-ai@latest workspace remove frontend

# reconciliar: clona os membros declarados que faltam + adota pastas git órfãs
npx n45-ai@latest workspace sync
  • remove é seguro: só desregistra do workspace, não apaga nada. Ele bloqueia se o membro participa de uma feature em andamento (finalize ou cancele a feature antes).
  • sync é útil ao clonar o repositório do workspace numa máquina nova: ele clona os membros que faltam e adota as pastas git que ainda não são membros.

O que fica versionado

O workspace é ele próprio um repositório git, mas versiona apenas a coordenação — o .n45/ do workspace (specs, contracts, docs da feature). Os membros são repositórios independentes e ficam de fora automaticamente: você cria, clona e mexe nas pastas dos membros à vontade, e elas só entram no workspace quando você roda workspace add.

Veja também