ide/architecture.md

Architecture

Git.Zone IDE is split into a local Electron shell and a remote Theia workspace server.

Local Electron Shell

The Electron app is intentionally small. It owns SSH host selection, remote bootstrap execution, local SSH tunnel lifecycle, and workspace windows. It does not implement remote filesystem, terminal, Git, or OpenCode behavior itself.

Remote Theia Server

The remote server is a Theia browser application installed under ~/.git.zone/ide-server/<version>. It runs on the SSH host, bound to 127.0.0.1, and is accessed only through an SSH local port forward.

OpenCode Integration

The @git.zone/ide-extension-opencode backend starts or connects to opencode serve in the remote workspace. The Theia frontend talks to that backend over Theia JSON-RPC. The browser never receives the OpenCode server password and never talks to OpenCode HTTP directly.

Execution Boundary

Files, terminal commands, Git, language servers, builds, tests, Git.Zone commands, and OpenCode tools all run on the remote SSH host. The local machine only displays UI and maintains SSH transport.