Windows (WSL)

Embora o aicippy-code possa rodar direto no Windows, recomendamos usar Windows Subsystem for Linux (WSL) para a melhor experiência. O WSL oferece um ambiente Linux que funciona de forma integrada com os recursos do aicippy-code.

Por que WSL?

O WSL oferece melhor desempenho de sistema de arquivos, suporte completo a terminal e compatibilidade com as ferramentas de desenvolvimento das quais o aicippy-code depende.

---

Configuração

1. Instale o WSL

   Se ainda não instalou, instale o WSL usando o guia oficial da Microsoft.

2. Instale o aicippy-code no WSL

   Depois de configurar o WSL, abra o terminal do WSL e instale o aicippy-code usando um dos métodos de instalação.

   curl -fsSL https://code.aicippy.com/install | bash

3. Use o aicippy-code pelo WSL

   Vá para o diretório do seu projeto (acesse arquivos do Windows via /mnt/c/, /mnt/d/ etc.) e execute o aicippy-code.

   cd /mnt/c/Users/YourName/project
   aicippy-code

---

App desktop + servidor WSL

Se você prefere usar o app desktop do aicippy-code, mas quer rodar o servidor no WSL:

1. Inicie o servidor no WSL com --hostname 0.0.0.0 para permitir conexões externas:

   aicippy-code serve --hostname 0.0.0.0 --port 4096

2. Conecte o app desktop em http://localhost:4096

Nota

Se localhost não funcionar no seu ambiente, conecte usando o IP do WSL (no WSL: hostname -I) e use http://<wsl-ip>:4096.

Cuidado

Ao usar --hostname 0.0.0.0, defina AICIPPY_CODE_SERVER_PASSWORD para proteger o servidor.

AICIPPY_CODE_SERVER_PASSWORD=your-password aicippy-code serve --hostname 0.0.0.0

---

Cliente web + WSL

Para a melhor experiência web no Windows:

1. Execute aicippy-code web no terminal WSL em vez do PowerShell:

   aicippy-code web --hostname 0.0.0.0

2. Acesse pelo navegador do Windows em http://localhost:<port> (o aicippy-code mostra a URL)

Executar aicippy-code web a partir do WSL garante acesso correto ao sistema de arquivos e integração com o terminal, continuando acessível no navegador do Windows.

---

Acessar arquivos do Windows

O WSL pode acessar todos os arquivos do Windows pelo diretório /mnt/:

• Unidade C: → /mnt/c/
• Unidade D: → /mnt/d/
• E assim por diante…

Exemplo:

cd /mnt/c/Users/YourName/Documents/project
aicippy-code

Dica

Para uma experiência mais fluida, considere clonar/copiar seu repositório para o sistema de arquivos do WSL (por exemplo em ~/code/) e executar o aicippy-code por lá.

---

Dicas

• Mantenha o aicippy-code rodando no WSL para projetos armazenados em unidades do Windows - o acesso aos arquivos fica fluido
• Use a extensão WSL do VS Code junto com o aicippy-code para um fluxo de desenvolvimento integrado
• Sua configuração e suas sessões do aicippy-code ficam armazenadas no ambiente WSL em ~/.local/share/aicippy-code/