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
- Feature Scout BriefThe product surface, the features worth exploring first, and why those features deserve attention beyond the README.
- Workspaces, Splits & Vertical SidebarHow cmux turns terminal tabs into a spatial workspace system with Bonsplit panes, draggable workspaces, sidebar metadata, pinning, and split equalization.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.