# Git.Zone IDE

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

The local Electron shell manages SSH sessions and tunnels. The remote host runs the Theia backend and OpenCode server inside the selected workspace, so files, terminals, Git, language servers, tests, and AI agent actions all execute where the code lives.

## Development

```sh
pnpm install
pnpm run build
pnpm run test
```

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

```sh
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.