Install the OpenRemote plugin

What it adds

• TUI sidebar QR code for fast OpenRemote connection.
• Keep-awake while OpenRemote is connected.
• Connection status visible inside OpenCode.

Setup

Use the setup wizard from Installation, or add the plugin entries manually.

Add the server plugin to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["opencode-openremote"]
}

Add the TUI sidebar plugin to tui.json:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["opencode-openremote/tui"]
}

Restart opencode for changes to take effect.

Connect

Restart OpenCode, open the OpenRemote sidebar QR code, then scan it from the app.

Open the getting started guide

Run from source

For unreleased plugin features, clone the repository and point your project-level OpenCode config at the local plugin files.

git clone https://github.com/blairhudson/openremote.git

In your OpenCode project, add opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["/path/to/openremote/packages/opencode-plugin/src/index.ts"]
}

For the TUI sidebar, add tui.json:

{
  "$schema": "https://opencode.ai/tui.json",
  "plugin": ["/path/to/openremote/packages/opencode-plugin/src/tui.tsx"]
}

Replace /path/to/openremote with the cloned repository path, then restart opencode.

Configuration

The TUI QR code includes separate OpenRemote proxy credentials. Leave OpenCode's built-in OPENCODE_SERVER_USERNAME and OPENCODE_SERVER_PASSWORD at their defaults unless you need them for OpenCode itself.