manaflow-ai

Opencode Cmux — Development skill for Claude Code

Development community

OpenCode plugin that bridges OpenCode events to cmux notifications and sidebar metadata.

How to install Opencode Cmux

This entry records only its repository, not the path inside it, so there is no exact command to give. Open manaflow-ai/opencode-cmux and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Opencode Cmux does

OpenCode plugin that bridges OpenCode events to cmux notifications and sidebar metadata.

Alternatives in Development

Happy Coder — by GrocerPublishAgent - Spawn and control multiple Claude Codes in parallel from your phone or desktop 15.7k ★
Peon Ping — Warcraft III Peon voice notifications (+ StarCraft, Portal, Zelda) for Claude Code and other agents 4k ★
Claude Island — Claude Code notifications without the context switch 1.1k ★

README

opencode-cmux

[![npm](https://img.shields.io/npm/v/opencode-cmux)](https://www.npmjs.com/package/opencode-cmux)

OpenCode plugin that bridges OpenCode events to cmux notifications and sidebar metadata.

Requirements

OpenCode ≥ 1.0
cmux (macOS app) installed with CLI accessible at /usr/local/bin/cmux
The plugin is a no-op when not running inside a cmux workspace

Installation

Add to `~/.config/opencode/opencode.json`:

{
  "plugin": ["opencode-cmux"]
}

OpenCode will download the package automatically on next start.

Local / development

Build the package, then symlink the output directly into OpenCode's plugin directory:

ln -sf ~/path/to/opencode-cmux/dist/index.js ~/.config/opencode/plugins/cmux.js

Make sure `opencode-cmux` is **not** listed in `opencode.json` when using the symlink, to avoid loading it twice.

What it does

Event	cmux action
Session starts working	Sidebar status: "working" (amber, terminal icon)
Session completes (primary)	Desktop notification + log + clear status
Session completes (subagent)	Log only (no notification spam)
Session error	Desktop notification + log + clear status
Permission requested	Desktop notification + sidebar status: "waiting" (red, lock icon)
AI has a question (`ask` tool)	Desktop notification + sidebar status: "question" (purple)

How it works

The plugin responds to OpenCode lifecycle events by firing cmux CLI commands (`cmux notify`, `cmux set-status`, etc.). Each action targets the current cmux workspace, providing ambient awareness of what OpenCode is doing without requiring you to switch context. All commands are no-ops when cmux is not running.