Registry / llm-agents / vite-plugin-opencode-assistant

vite-plugin-opencode-assistant

library1.0.53jsnpmunverified

A Vite plugin that embeds an OpenCode AI assistant panel directly into your dev server page, enabling real-time code modification through chat and instant preview via HMR. Current stable version is 1.0.53, released with a weekly cadence. Key differentiators: automatic session management, element selector for component source context, proxy service for cross-origin iframe support, and Chrome DevTools MCP warmup. Requires the OpenCode CLI to be installed separately and Vite >=4.0.0 as a peer dependency. Ships TypeScript types and supports configuration for theme, hotkeys, and language.

llm-agents web-framework ai-ml

npm install vite-plugin-opencode-assistant

package ↗

INSTALL

IMPORT

SIG · VITE-PLUGIN-OPENCO

vite-plugin-opencode-assistant

llm-agentsjavascriptv1.0.53

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

opencodeAssistant

✓ import opencodeAssistant from 'vite-plugin-opencode-assistant'

✗ const opencodeAssistant = require('vite-plugin-opencode-assistant')

ESM-only; package is a Vite plugin with TypeScript types, default export only

OpenCodeAssistantOptions

✓ import type { OpenCodeAssistantOptions } from 'vite-plugin-opencode-assistant'

✗ import { OpenCodeAssistantOptions } from 'vite-plugin-opencode-assistant'

Type import required; do not import as value

DefaultOpenCodeSettings

✓ import type { DefaultOpenCodeSettings } from 'vite-plugin-opencode-assistant'

✗ import { DefaultOpenCodeSettings } from 'vite-plugin-opencode-assistant'

Type import for the OpenCode settings object structure

Minimal Vite config with opencode-assistant plugin and customizable options for OpenCode Web UI integration.

// vite.config.ts import { defineConfig } from 'vite'; import opencodeAssistant from 'vite-plugin-opencode-assistant'; export default defineConfig({ plugins: [ opencodeAssistant({ enabled: true, webPort: 5097, proxyPort: 6097, hostname: '127.0.0.1', theme: 'auto', hotkey: 'ctrl+k', warmupChromeMcp: true, }), ], });

Debug

Known issues

breakingvite-plugin-opencode-assistant requires Vite >=4.0.0; using with older versions will cause plugin loading failures.

fix

Upgrade Vite to >=4.0.0.

affects: <1.0.0

breakingOpenCode CLI must be installed separately (via curl, npm, or brew) before the plugin can start its services.

fix

Install OpenCode CLI: curl -fsSL https://opencode.ai/install | bash

affects: >=1.0.0

gotchaThe plugin uses default export only; named exports are types. Attempting to destructure a named function will result in undefined.

fix

Use default import: import opencodeAssistant from 'vite-plugin-opencode-assistant'

affects: >=1.0.0

gotchaProxy port (proxyPort) must not conflict with other local services; if the port is in use, the plugin may fail silently.

fix

Configure distinct ports or ensure proxyPort is available.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'vite-plugin-opencode-assistant'

Package not installed or not in node_modules.

fix

Run `npm install -D vite-plugin-opencode-assistant` in your project root.

TypeError: opencodeAssistant is not a function

Probably using named import instead of default import.

fix

Use `import opencodeAssistant from 'vite-plugin-opencode-assistant'` instead of `import { opencodeAssistant } from ...`

Error: require() of ES Module not supported

Using CommonJS require() to import an ESM-only package.

fix

Switch to ESM (use import statement) or configure your project to support ESM.

Upgrade

Version history

1.0.53latest on npm

Audit

Dependencies

viterequiredPeer dependency: requires Vite >=4.0.0 to run as a plugin

Agent activity

48 hits · last 30 days

node

Bingbot

Perplexity

OpenAI (training)

Resources

packagehttps://www.npmjs.com/package/vite-plugin-opencode-assistant ↗