cyber-mux 0.7.0 → 0.9.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,14 @@
+{
+	"name": "cyber-mux",
+	"version": "0.8.0",
+	"description": "Cross-multiplexer pane control: open, send, read, focus, and close panes over tmux, herdr, wezterm, and more.",
+	"author": {
+		"name": "unional",
+		"email": "homawong@gmail.com"
+	},
+	"homepage": "https://cyberuni.github.io/cyber-mux/",
+	"repository": "https://github.com/cyberuni/cyber-mux",
+	"license": "MIT",
+	"keywords": ["tmux", "herdr", "multiplexer", "terminal", "pane", "agent"],
+	"skills": "./skills/"
+}

package/.codex-plugin/plugin.json

@@ -0,0 +1,17 @@
+{
+	"name": "cyber-mux",
+	"version": "0.8.0",
+	"description": "Cross-multiplexer pane control: open, send, read, focus, and close panes over tmux, herdr, wezterm, and more.",
+	"author": {
+		"name": "unional",
+		"email": "homawong@gmail.com"
+	},
+	"homepage": "https://cyberuni.github.io/cyber-mux/",
+	"repository": "https://github.com/cyberuni/cyber-mux",
+	"license": "MIT",
+	"keywords": ["tmux", "herdr", "multiplexer", "terminal", "pane", "agent"],
+	"skills": "./skills/",
+	"interface": {
+		"displayName": "cyber-mux"
+	}
+}

package/.cursor-plugin/plugin.json

@@ -0,0 +1,14 @@
+{
+	"name": "cyber-mux",
+	"version": "0.8.0",
+	"description": "Cross-multiplexer pane control: open, send, read, focus, and close panes over tmux, herdr, wezterm, and more.",
+	"author": {
+		"name": "unional",
+		"email": "homawong@gmail.com"
+	},
+	"homepage": "https://cyberuni.github.io/cyber-mux/",
+	"repository": "https://github.com/cyberuni/cyber-mux",
+	"license": "MIT",
+	"keywords": ["tmux", "herdr", "multiplexer", "terminal", "pane", "agent"],
+	"skills": "./skills/"
+}

package/README.md

@@ -0,0 +1,75 @@
+# cyber-mux
+
+[![npm version](https://img.shields.io/npm/v/cyber-mux.svg)](https://www.npmjs.com/package/cyber-mux)
+[![npm downloads](https://img.shields.io/npm/dm/cyber-mux.svg)](https://www.npmjs.com/package/cyber-mux)
+[![release](https://github.com/cyberuni/cyber-mux/actions/workflows/release.yml/badge.svg)](https://github.com/cyberuni/cyber-mux/actions/workflows/release.yml)
+[![docs](https://img.shields.io/badge/docs-cyberuni.github.io-blue)](https://cyberuni.github.io/cyber-mux/)
+[![license](https://img.shields.io/npm/l/cyber-mux.svg)](https://www.npmjs.com/package/cyber-mux)
+
+Cross-multiplexer pane control for AI-agent tooling. One contract over terminal multiplexers — open,
+send, read, focus, and close panes without caring which multiplexer you are inside.
+
+`cyber-mux` is the mux seam used by [`cyberlegion`](https://github.com/cyberuni/cyberplace), kept
+deliberately narrow: it drives panes and nothing else.
+
+Part of [cyber-civitas](https://cyber-civitas.github.io), a self-contained system for running AI coding agents. This package is its pane control beneath the runtime layer.
+
+## Install
+
+```bash
+npx cyber-mux mode
+```
+
+## What it does
+
+- **Detects** the multiplexer you are running under — env fast-path (`CYBER_MUX` / `CYBER_MUX_PANE`),
+  otherwise a process-ancestry walk falling back to the multiplexer's own env hints.
+- **Drives panes** through one `MuxAdapter` contract: `open`, `send`, `submit`, `read`, `wait`,
+  `focus`, `close`, `list`, `exists`.
+- **Nudges** a peer pane and verifies the turn was actually taken (recovers a submit swallowed by a
+  booting harness).
+- **Worktrees**: create a git worktree and open it in a new workspace/session in one step.
+
+## Backends
+
+Drivable: **tmux**, **rmux**, **herdr**, **wezterm**, **zellij**, **cmux**, **otty**.
+
+GNU **screen** is recognized and reported truthfully, then rejected with a named error rather than
+driven — it addresses panes positionally, so a driver-created pane has no stable identity to send to,
+read from, or self-identify by.
+
+## Commands
+
+| Command | Description |
+| --- | --- |
+| `cyber-mux doctor` | Probe the multiplexer, self pane, and backend; print fast-path pins |
+| `cyber-mux mode` | Report the detected session backend |
+| `cyber-mux open` | Open a new pane/tab/workspace, optionally launching a command in it |
+| `cyber-mux send` | Drive a pane without taking its turn (text or keys) |
+| `cyber-mux submit` | Take a pane's turn: type the text if given, then press Enter |
+| `cyber-mux read` | Capture a pane's output |
+| `cyber-mux wait` | Block until a pane's output matches (exit 0), or the timeout elapses (exit 1) |
+| `cyber-mux focus` | Beam the attached client to a pane |
+| `cyber-mux close` | Close a pane |
+| `cyber-mux list` / `exists` | Enumerate live panes / probe whether one is still live |
+| `cyber-mux worktree` | Git worktree helpers for spawning and tearing down a session |
+| `cyber-mux template` | Manage named templates (apply one with `open`/`worktree --template`) |
+| `cyber-mux agent` | Inspect and wait on a pane's agent-lifecycle state |
+
+Full reference: <https://cyberuni.github.io/cyber-mux/>
+
+## Development
+
+Node and pnpm are pinned in `mise.toml` and managed by [mise](https://mise.jdx.dev):
+
+```bash
+mise install  # node + pnpm at the pinned versions
+pnpm install
+pnpm verify   # build + typecheck + lint + test
+```
+
+The CLI lives in `packages/cyber-mux`; the docs site in `apps/website` (Astro + Starlight).
+
+## License
+
+MIT

package/dist/agent.d.mts

@@ -1,5 +1,5 @@
 import { t as Exec } from "./exec-B81m4yjz.mjs";
-import { m as MuxTarget, n as AgentStatus, o as MuxAdapter, r as AgentWaitOptions, t as AgentLifecycle } from "./mux-CDrZQglk.mjs";
+import { m as MuxTarget, n as AgentStatus, o as MuxAdapter, r as AgentWaitOptions, t as AgentLifecycle } from "./mux-DOhM8bnO.mjs";
 //#region src/agent-states.d.ts
 /**
  * The agent-wait STATE-SET refusal — what an `AgentLifecycle` backend answers when it has the native

package/dist/agent.mjs

@@ -1,5 +1,5 @@
-import { h as nodeExec } from "./worktree-Bj6IgHv7.mjs";
-import { b as agentWaitStatesSatisfiable, r as resolveMuxAdapter, x as refuseAgentWaitStates, y as AgentWaitStatesUnsupportedError } from "./backend-Dg5JGbd3.mjs";
+import { V as nodeExec } from "./worktree-08MMRO3P.mjs";
+import { b as agentWaitStatesSatisfiable, r as resolveMuxAdapter, x as refuseAgentWaitStates, y as AgentWaitStatesUnsupportedError } from "./backend-26cY2q8x.mjs";
 //#region src/agent.ts
 /**
 * An agent-lifecycle wait asked of a backend that has no native agent-state primitive (`agent wait` on

package/dist/{backend-Dg5JGbd3.mjs → backend-26cY2q8x.mjs}

@@ -1,4 +1,4 @@
-import { c as normalizeWorktreePath, g as withReason, h as nodeExec } from "./worktree-Bj6IgHv7.mjs";
+import { H as withReason, V as nodeExec, c as normalizeWorktreePath } from "./worktree-08MMRO3P.mjs";
 import { resolve } from "node:path";
 import { randomUUID } from "node:crypto";
 //#region src/env-fallback.ts
@@ -6202,4 +6202,4 @@ function callerPane(adapter, env) {
 //#endregion
 export { DEFAULT_WAIT_POLL_MS as A, restoringFocus as B, partition as C, PaneZoomUnsupportedError as D, isReadTruncated as E, PaneMoveUnsupportedError as F, envFallback as G, FloatingPanesUnsupportedError as H, canBreakPanes as I, canMovePanes as L, matchWaitPattern as M, pollForOutput as N, canZoomPanes as O, PaneBreakUnsupportedError as P, refusePaneBreak as R, herdrMuxAdapter as S, capturedRows as T, canFloatPanes as U, soleFocusedPane as V, refuseFloatingPane as W, RMUX_WORKSPACE_GROUP_OPTION as _, nudge as a, agentWaitStatesSatisfiable as b, createZellijAdapter as c, weztermMuxAdapter as d, nodeNewId as f, RMUX_TAB_NAME_OPTION as g, tmuxMuxAdapter as h, isStaged as i, assertWaitPattern as j, refusePaneZoom as k, zellijMuxAdapter as l, TMUX_WORKSPACE_GROUP_OPTION as m, resolveMux as n, currentPane as o, TMUX_TAB_NAME_OPTION as p, resolveMuxAdapter as r, probeMultiplexer as s, callerPane as t, createWeztermAdapter as u, rmuxMuxAdapter as v, FULL_SCROLLBACK_LINES as w, refuseAgentWaitStates as x, AgentWaitStatesUnsupportedError as y, refusePaneMove as z };
 
-//# sourceMappingURL=backend-Dg5JGbd3.mjs.map
+//# sourceMappingURL=backend-26cY2q8x.mjs.map