Remote Development

Work against a different machine — a cloud VM, a Raspberry Pi, a container, or a machine behind a firewall — with the same editor experience as working locally.

Remote Tunnels

Gunamaya can open a secure tunnel to any machine it's running on, letting you connect to that machine's filesystem, terminal, and running processes from a different Gunamaya window — no port forwarding or VPN setup required.

1

Start a tunnel on the remote machine

Run Turn on Remote Tunnel Access from the Command Palette on the machine you want to connect to (a home server, a cloud VM, a Raspberry Pi).

2

Sign in to authorize the tunnel

A one-time device sign-in links the tunnel to your account so only you can connect to it.

3

Connect from anywhere

From a different Gunamaya install, run Connect to Tunnel… and pick the machine you started a tunnel on — its full file system and terminal are now available as if you'd opened them locally.

Tunnels persist across network changes

A tunnel survives your local machine's network changing (switching Wi-Fi networks, going through a VPN) — reconnect from a fresh Gunamaya window at any point without restarting anything on the remote machine.

SSH

For a remote machine you already access via SSH, install the SSH-based remote development extension from Open VSX to open a folder on that machine directly, with the same Explorer, terminal, and debugging experience as a local folder — Gunamaya's UI stays on your local machine while the actual files, processes, and extensions run on the remote host.

WSL (Windows Subsystem for Linux)

On Windows, install the WSL extension to open a folder living inside a WSL distribution directly — useful when your project's tooling assumes a Linux environment but you're developing on a Windows machine. See Gunamaya on Windows for more context on when this is worth setting up.

Dev Containers

For a fully reproducible, containerized development environment defined in your repository itself (a .devcontainer folder describing the exact image, tools, and extensions a project needs), install the Dev Containers extension to open your project inside that container with one click — every contributor gets an identical environment regardless of what's installed on their own machine.

Remote development and Gunamaya AI

Gunamaya AI works the same way whether your workspace is local, tunneled, over SSH, or inside a Dev Container — it reads files, runs commands, and drives the Integrated Browser against whichever environment your window is currently connected to.