JSPM

@warp-dot-dev/opencode-warp

0.1.6
  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1780
  • Score
    100M100P100Q131388F
  • License MIT

Warp terminal integration for OpenCode — native notifications and more

Package Exports

  • @warp-dot-dev/opencode-warp
  • @warp-dot-dev/opencode-warp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@warp-dot-dev/opencode-warp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

OpenCode + Warp

Official Warp terminal integration for OpenCode.

Features

🔔 Native Notifications

Get native Warp notifications when OpenCode:

  • Completes a task — with a summary showing your prompt and the response
  • Needs your input — when a permission request is pending
  • Runs a tool — status updates as tools execute

Notifications appear in Warp's notification center and as system notifications, so you can context-switch while OpenCode works and get alerted when attention is needed.

Installation

Add the plugin to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": ["@warp-dot-dev/opencode-warp"]
}

From local files

Copy or symlink the built plugin into your OpenCode plugins directory:

# Global
cp dist/index.js ~/.config/opencode/plugins/opencode-warp.js

# Or project-level
cp dist/index.js .opencode/plugins/opencode-warp.js

Requirements

How It Works

This plugin uses Warp's pluggable notifications feature via OSC escape sequences. When OpenCode triggers an event, the plugin:

  1. Reads event data from OpenCode's plugin API
  2. Formats a concise notification payload
  3. Sends an OSC 777 escape sequence to Warp, which displays a native notification

The plugin hooks into these OpenCode events:

  • session.created — confirms the plugin is active
  • session.idle — fires when OpenCode finishes responding, includes your prompt and the response
  • permission.updated / permission.asked — fires when OpenCode needs tool approval
  • message.updated — fires when a user prompt is submitted
  • tool.execute.after — fires when a tool call completes

Configuration

Notifications work out of the box. To customize Warp's notification behavior (sounds, system notifications, etc.), see Warp's notification settings.

Development

# Install dependencies
bun install

# Type check
bun run typecheck

# Run tests
bun test

# Build
bun run build

Uninstall

Remove "@warp-dot-dev/opencode-warp" from the plugin array in your opencode.json.

Contributing

Contributions welcome! Please open an issue or PR on GitHub.

License

MIT License — see LICENSE for details.