Começar

Windows

#Caminho recomendado: WSL2

Execute o Cockpit dentro do WSL2, com Node, Git, Python e CLIs de IA no mesmo ambiente. No PowerShell como administrador:

wsl --install

Reinicie quando solicitado, abra o Ubuntu instalado e crie seu usuário Linux. O comando instala Ubuntu por padrão e as novas instalações usam WSL2. Para esse procedimento, a Microsoft exige Windows 10 versão 2004/build 19041 ou superior, ou Windows 11. Veja o guia oficial do WSL.

Confira no PowerShell:

wsl --list --verbose

Dentro do Ubuntu, siga a seção Linux. Guarde o checkout, por exemplo, em ~/Projetos/cockpit. Abra a interface no navegador do Windows em http://localhost:4000.

Os caminhos informados ao servidor são Linux, como /home/seu-usuario/Projetos/meu-app. Pastas Windows podem aparecer como /mnt/c/...; manter projetos no filesystem Linux simplifica permissões e symlinks. Instalar um CLI somente no Windows não configura automaticamente sua versão no WSL.

#Limitações do Windows nativo

npm start usa expansão POSIX (COCKPIT_HOST=${COCKPIT_HOST:-0.0.0.0}), incompatível com o shell padrão do npm no Windows. A ponte Python é desabilitada em win32; /bin/bash e os sockets/permissões das sessões também exigem adaptação. Git Bash sozinho não resolve todas essas diferenças.

Em um checkout já instalado e compilado, é possível consultar o CLI diretamente no PowerShell:

node .\bin\cockpit.js --help
node .\bin\cockpit.js --version

Isso não comprova suporte completo a terminais/sessões nativos. Para uso normal, siga WSL2.