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

Cmux — cmux: tmux for Claude Code 600 ★
Obsidian Claude Sidebar — Run Claude Code, Codex, and other agent CLIs in Obsidian 451 ★
Cmux Did Spawn — Orient yourself as orchestrator over a full-stack team that was just scripted into its own cmux window 107 ★

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.