Cmux Agent Orchestrator banner
swayamg20 swayamg20

Cmux Agent Orchestrator

Development community

Description

Coordinate Claude Code and Codex sessions running in cmux from Obsidian.

Installation

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

README

cmux Agent Orchestrator

cmux Agent Orchestrator is a desktop-only Obsidian community plugin for coordinating Claude Code and Codex CLI sessions that already run inside cmux. It is a human-in-the-loop orchestration layer: Obsidian owns durable work context, cmux remains the terminal and process owner, and each provider retains its own session state.

The repository currently targets Obsidian 1.10.x and the installed cmux 0.62.2 command surface. It has no runtime npm dependencies, telemetry, hosted service, or external network requirement.

Install

Install cmux Agent Orchestrator from its [Obsidian Community Plugins listing](https://community.obsidian.md/plugins/cmux-agent-orchestrator), or [open it directly in Obsidian](obsidian://show-plugin?id=cmux-agent-orchestrator).

Screenshots

Work

![Work view with attention signals and the durable task board](screenshots/work.png)

Agent runs

![Detected Claude and Codex runs ready to track on the work board](screenshots/agent-runs.png)

cmux

![Live cmux workspace, pane, and terminal-surface hierarchy](screenshots/cmux.png)

What the current build provides

  • One native Obsidian ItemView, opened from the ribbon or command palette.
  • Three focused native modes: Work for attention and the durable board, Agent runs for untracked Claude/Codex executions, and cmux for the exact terminal tree.
  • All five workflow columns are always visible, including in a brand-new vault with no task notes.
  • Canonical workspace, pane, and surface UUIDs from cmux JSON output.
  • Conservative Claude, Codex, shell, and unknown detection with evidence and confidence.
  • Automatic provider conversation titles when an exact surface/process/session correlation is provable, with a manual picker fallback.
  • Bounded, memory-only terminal previews loaded only when a session is expanded or explicitly requested.
  • Exact Focus in cmux with fresh target resolution and bounded postcondition retries.
  • Markdown task creation and workflo