DEV Community

Cover image for Mobile Push Notifications With Opencode
Tobrun Van Nuland
Tobrun Van Nuland

Posted on

Mobile Push Notifications With Opencode

Lately, I’ve been very deliberately splitting my work into two distinct modes.

The first is a more curated, quality-driven workflow where I use coding agents with line-by-line review. This is the mode I rely on when correctness and maintainability matter most, and it’s where I primarily work with Claude Code.

The second mode is closer to vibe-coding: experimenting with more speculative ideas, exploring “crazy” concepts, and building small proof-of-concepts quickly. For this, I run local LLMs on my own server and connect via SSH to execute Opencode directly on the machine.

By leveraging https://github.com/code-yeongyu/oh-my-opencode
, I can run long-running plans autonomously. The downside, however, is that I often don’t notice when an agent has finished executing. To solve this, I put together a minimal setup that sends me a push notification whenever an Opencode coding agent becomes idle.

So I ended up building opencode-notify.


What opencode-notify Does

opencode-notify is a tiny OpenCode plugin that sends push notifications to your phone using Pushover when a session finishes.


Installation

1. Set up Pushover

  1. Install Pushover on your phone
  2. Create an account and note your User Key
  3. Create an application and note the API Token

2. Install the plugin

mkdir -p ~/.config/opencode/plugins
curl -o ~/.config/opencode/plugins/opencode-notify.js \
  https://raw.githubusercontent.com/tobrun/opencode-notify/main/index.js
Enter fullscreen mode Exit fullscreen mode

3. Set environment variables

Add to your shell profile:

export PUSHOVER_APP_TOKEN="your-app-token"
export PUSHOVER_USER_KEY="your-user-key"
Enter fullscreen mode Exit fullscreen mode

4. Restart OpenCode

Done. The plugin loads automatically.


Configuration

Variable Required Description
PUSHOVER_APP_TOKEN Yes Pushover application token
PUSHOVER_USER_KEY Yes Pushover user key
OPENCODE_NOTIFY No Set to 0 to disable

Repo: https://github.com/tobrun/opencode-notify

Top comments (0)