Agent-readable wiki

cmux Feature Scout Wiki

A fast discovery wiki for cmux, a native macOS terminal workbench with agent-aware notifications, browser sidecars, automation, remote workspaces, and provider-neutral Cloud VM plumbing. The table of contents favors source-backed features worth demoing, copying, or productizing beyond the README.

Pages

  1. Feature Scout BriefThe product surface, the features worth exploring first, and why those features deserve attention beyond the README.
  2. Workspaces, Splits & Vertical SidebarHow cmux turns terminal tabs into a spatial workspace system with Bonsplit panes, draggable workspaces, sidebar metadata, pinning, and split equalization.
  3. Agent Notification Rings & InboxThe unread-state system that converts terminal notifications, hook events, and CLI notifications into pane rings, sidebar badges, a review page, and jump-to-unread workflows.
  4. Command Palette, Nucleo Search & Editable ShortcutsThe power-user command layer: native fuzzy search, usage boosts, settings toggles, shortcut recording, JSON-backed shortcut files, and tests that preserve keyboard routing behavior.
  5. CLI & Socket Automation APIThe scriptable control plane for workspaces, panes, surfaces, browser actions, notifications, windows, and VM commands, including tagged socket resolution and v2 method dispatch.
  6. Agent Hook Library & Permission FeedThe vendor-agnostic hook adapter layer for Codex, Grok, OpenCode, Gemini, Cursor, Rovo Dev, Hermes Agent, and other agents, plus the feed path for approval and permission events.
  7. Session Vault & Agent ResumeThe restorable-agent index that scans agent stores, groups sessions by folder or agent, uses SQL for Codex state when available, and supports drag-to-resume workflows.
  8. Project Commands, Surface Buttons & Trust GatesThe configuration mechanics behind project-specific commands, surface tab bar buttons, notification hooks, workspace commands, and confirmation gates for local automation.
  9. In-App Browser Pane AutomationThe WKWebView sidecar experience for authenticated browser panes, omnibar behavior, find-in-page scripts, devtools affordances, and socket-driven browser automation.
  10. Files, Markdown & Preview SidecarsThe right-sidebar file workflow that mixes file search, terminal path insertion, command-click routing, Markdown rendering, PDF/image previews, and review-feedback surfaces.
  11. Remote Machines: SSH, Loopback & Cloud VMThe remote-work architecture that combines local SSH workspaces, remote localhost browser routing, image upload planning, Cloud VM attach endpoints, and a provider registry that stays BYOC and BYOK friendly.
  12. What To Demo, Copy or Productize NextA closing scout map of the strongest reusable product ideas: composable terminal primitives, source-portable skill and hook adapters, browser-plus-terminal automation, provider-neutral remote compute, and trust-gated project actions.

Complete Markdown

The complete agent-readable Markdown files are published separately from this HTML page.