ide/readme.md

Git.Zone IDE

Git.Zone IDE is a remote-first desktop IDE based on Eclipse Theia, Electron, SSH, and OpenCode.

The local Electron shell manages SSH sessions, tunnels, and the native OpenCode chat runtime. The remote host runs the Theia backend inside the selected workspace; OpenCode code tools are overridden so file, shell, search, and patch actions execute remotely over SSH where the code lives.

Development

pnpm install
pnpm run build
pnpm run test

The full Theia product build is intentionally separate because it downloads and bundles the IDE runtime:

pnpm run build:theia
pnpm run start:remote

Architecture

• applications/electron-shell: local Electron launcher and SSH session shell.
• applications/remote-theia: remote Theia application served through an SSH tunnel.
• packages/ssh: OpenSSH config parsing, command execution, probes, and tunnel lifecycle.
• packages/server-installer: remote server manifest, install paths, bootstrap script generation, and command planning.
• packages/opencode-bridge: typed OpenCode server client wrapper and event normalization.
• packages/protocol: shared session and server protocol types.
• theia-extensions/gitzone-*: Theia product, remote, and OpenCode integration extensions.