Windows (WSL)

Запускайте vikasit в Windows через WSL.

vikasit можно запускать напрямую в Windows, но для лучшего опыта мы рекомендуем Windows Subsystem for Linux (WSL). WSL дает Linux-среду, которая отлично работает с возможностями vikasit.

Настройка

Установите WSL

Если вы еще не сделали этого, установите WSL по официальному руководству Microsoft.
Установите vikasit в WSL

После настройки WSL откройте терминал WSL и установите vikasit одним из способов установки.
Окно терминала
```
curl -fsSL https://opencode.ai/install | bash
```
Запускайте vikasit из WSL

Перейдите в каталог проекта (к файлам Windows можно обращаться через /mnt/c/, /mnt/d/ и т.д.) и запустите vikasit.
Окно терминала
```
cd /mnt/c/Users/YourName/project
vikasit
```

Десктопное приложение + сервер в WSL

Если вы предпочитаете vikasit Desktop, но хотите запускать сервер в WSL:

Запустите сервер в WSL с параметром --hostname 0.0.0.0, чтобы разрешить внешние подключения:
Окно терминала
```
vikasit serve --hostname 0.0.0.0 --port 4096
```
Подключите десктопное приложение к http://localhost:4096

При использовании --hostname 0.0.0.0 задайте VIKASIT_SERVER_PASSWORD, чтобы защитить сервер.

VIKASIT_SERVER_PASSWORD=your-password vikasit serve --hostname 0.0.0.0

Веб-клиент + WSL

Для лучшего веб-опыта в Windows:

Запускайте vikasit web в терминале WSL, а не в PowerShell:
Окно терминала
```
vikasit web --hostname 0.0.0.0
```
Открывайте в браузере Windows адрес http://localhost:<port> (vikasit выведет URL)

Запуск vikasit web из WSL обеспечивает корректный доступ к файловой системе и интеграцию с терминалом, при этом интерфейс остается доступным из браузера Windows.

Доступ к файлам Windows

WSL может получать доступ ко всем вашим файлам Windows через каталог /mnt/:

C: drive → /mnt/c/
D: drive → /mnt/d/
И так далее

Пример:

cd /mnt/c/Users/YourName/Documents/project
vikasit

Советы

Даже для проектов на дисках Windows запускайте vikasit в WSL, чтобы получить более плавный доступ к файлам
Используйте vikasit вместе с расширением WSL для VS Code для единого рабочего процесса
Конфигурация и сессии vikasit хранятся в среде WSL по пути ~/.local/share/opencode/