# 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.

This is a Grok-Wiki source-grounded repository wiki. Use the complete Markdown link when an agent needs the full repo context.

## Context Links

- [Complete Markdown wiki](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/llms-full.txt)
- [Complete Markdown alias](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a.md)
- [Human interactive wiki](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a)
- [GitHub repository](https://github.com/manaflow-ai/cmux)

## Repository

- Repository: manaflow-ai/cmux

- Generated: 2026-05-23T17:54:24.269Z
- Updated: 2026-05-23T17:55:54.525Z
- Runtime: Codex CLI
- Format: Feature Scout
- Pages: 12

## Pages

- [Feature Scout Brief](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/01-feature-scout-brief.md): The product surface, the features worth exploring first, and why those features deserve attention beyond the README.
- [Workspaces, Splits & Vertical Sidebar](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/02-workspaces-splits-vertical-sidebar.md): How cmux turns terminal tabs into a spatial workspace system with Bonsplit panes, draggable workspaces, sidebar metadata, pinning, and split equalization.
- [Agent Notification Rings & Inbox](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/03-agent-notification-rings-inbox.md): The 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 Shortcuts](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/04-command-palette-nucleo-search-editable-shortcuts.md): The 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 API](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/05-cli-socket-automation-api.md): The 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 Feed](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/06-agent-hook-library-permission-feed.md): The 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 Resume](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/07-session-vault-agent-resume.md): The 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 Gates](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/08-project-commands-surface-buttons-trust-gates.md): The configuration mechanics behind project-specific commands, surface tab bar buttons, notification hooks, workspace commands, and confirmation gates for local automation.
- [In-App Browser Pane Automation](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/09-in-app-browser-pane-automation.md): The WKWebView sidecar experience for authenticated browser panes, omnibar behavior, find-in-page scripts, devtools affordances, and socket-driven browser automation.
- [Files, Markdown & Preview Sidecars](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/10-files-markdown-preview-sidecars.md): The 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 VM](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/11-remote-machines-ssh-loopback-cloud-vm.md): The 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 Next](https://grok-wiki.com/public/wiki/manaflow-ai-cmux-5a511656cb1a/pages/12-what-to-demo-copy-or-productize-next.md): A 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.

## Source Files

- `CLI/CLISocketPathResolver.swift`
- `CLI/cmux.swift`
- `CLI/CMUXCLI+AgentHookDefinitions.swift`
- `CLI/CMUXCLI+HermesAgentHooks.swift`
- `CLI/CMUXCLI+SSHCommandSupport.swift`
- `CLI/SocketOperationTelemetry.swift`
- `cmuxTests/BrowserImportMappingTests.swift`
- `cmuxTests/BrowserPanelTests.swift`
- `cmuxTests/CLIGenericHookPersistenceTests.swift`
- `cmuxTests/CmuxConfigContextMenuTests.swift`
- `cmuxTests/CmuxConfigTests.swift`
- `cmuxTests/CommandPaletteNucleoFFITests.swift`
- `cmuxTests/FeedCoordinatorTests.swift`
- `cmuxTests/FileExplorerStoreTests.swift`
- `cmuxTests/FilePreviewReviewFeedbackTests.swift`
- `cmuxTests/RestorableAgentSessionIndexTests.swift`
- `cmuxTests/SessionIndexViewTests.swift`
- `cmuxTests/ShortcutAndCommandPaletteTests.swift`
- `cmuxTests/TerminalControllerSocketSecurityTests.swift`
- `cmuxTests/TerminalNotificationQueueTests.swift`
- `cmuxUITests/AutomationSocketUITests.swift`
- `cmuxUITests/BonsplitTabDragUITests.swift`
- `cmuxUITests/JumpToUnreadUITests.swift`
- `Native/CommandPaletteNucleoFFI/src/lib.rs`
- `package.json`
- `Packages/CMUXAgentLaunch/Sources/CMUXAgentLaunch/HermesAgentHookConfig.swift`
- `Packages/CMUXAgentLaunch/Sources/CMUXAgentLaunch/RovoDevHookConfig.swift`
- `README.md`
- `Sources/BrowserWindowPortal.swift`
- `Sources/Cloud/VMClient.swift`
- `Sources/Cloud/VMClientSocketCommands.swift`
- `Sources/cmuxApp.swift`
- `Sources/CmuxConfig.swift`
- `Sources/CmuxConfigExecutor.swift`
- `Sources/CmuxSurfaceTabBarBuiltInAction.swift`
- `Sources/CommandClickFileOpenRouter.swift`
- `Sources/CommandPalette/CommandPaletteSearchOrchestrator.swift`
- `Sources/CommandPalette/CommandPaletteSettingsToggle.swift`
- `Sources/ContentView.swift`
- `Sources/Feed/FeedCoordinator.swift`
- `Sources/Feed/FeedPermissionActionPolicy.swift`
- `Sources/FileExplorerStore.swift`
- `Sources/FileExplorerTerminalPathInsertion.swift`
- `Sources/Find/BrowserFindJavaScript.swift`
- `Sources/Find/BrowserSearchOverlay.swift`
- `Sources/KeyboardShortcutSettings.swift`
- `Sources/KeyboardShortcutSettingsFileStore.swift`
- `Sources/NotificationsPage.swift`
- `Sources/Panels/BrowserPanel.swift`
- `Sources/Panels/BrowserPanelView.swift`
- `Sources/Panels/FilePreviewPanel.swift`
- `Sources/Panels/FilePreviewWorkspaceOpenSupport.swift`
- `Sources/Panels/MarkdownPanel.swift`
- `Sources/RemoteLoopbackRuntimeBridge.swift`
- `Sources/RestorableAgentTypes.swift`
- `Sources/SessionAgentPresentation.swift`
- `Sources/SessionIndexModels.swift`
- `Sources/SessionIndexStore.swift`
- `Sources/SessionIndexStore+CodexSQL.swift`
- `Sources/SessionIndexView.swift`
- `Sources/Settings/ConfigSettingsView.swift`
- `Sources/Sidebar/SidebarDropPlanner.swift`
- `Sources/Sidebar/SidebarState.swift`
- `Sources/TabManager.swift`
- `Sources/TerminalController.swift`
- `Sources/TerminalControllerV2ParamParsingSupport.swift`
- `Sources/TerminalImageTransfer.swift`
- `Sources/TerminalNotificationCallerResolver.swift`
- `Sources/TerminalNotificationPolicy.swift`
- `Sources/TerminalNotificationQueue.swift`
- `Sources/TerminalNotificationStore.swift`
- `Sources/Workspace.swift`
- `Sources/Workspace+EqualizeSplitsSupport.swift`
- `Sources/WorkspaceActionDispatcher.swift`
- `Sources/WorkspaceContentView.swift`
- `Sources/WorkspaceRemoteConfiguration.swift`
- `tests_v2/test_cli_browser_console_errors_text.py`
- `tests_v2/test_tab_dragging.py`
- `web/package.json`
- `web/services/vms/drivers/index.ts`
- `web/services/vms/drivers/types.ts`
- `web/services/vms/providerGateway.ts`
- `web/services/vms/workflows.ts`