# cmux | manaflow-ai | Knowledge Base | Instagit

Ghostty-based macOS terminal with vertical tabs and notifications for AI coding agents

GitHub Stars: 11.2k

Repository: https://github.com/manaflow-ai/cmux

---

## Articles

### [Common Issues with Nested Split Layouts in cmux: Focus, Drift, and Ordering Fixes](/manaflow-ai/cmux/common-issues-with-nested-split-layouts-in-cmux-and-handling)

Solve common cmux nested split layout issues like focus drift and ordering mismatch. Learn how to fix stale focus, sync dividers, and ensure correct pane order with our expert solutions.

- Tags: deep-dive
- Published: 2026-03-29

### [How cmux Integrates with AppleScript and System Automation](/manaflow-ai/cmux/how-cmux-integrates-with-applescript-and-system-automation)

Discover how cmux integrates with AppleScript for powerful macOS system automation. Programmatically control windows, tabs, panes, and text injection in your terminal workflow.

- Tags: how-to-guide
- Published: 2026-03-29

### [Localization and Internationalization Support in cmux: Architecture and Implementation](/manaflow-ai/cmux/cmux-localization-and-internationalization-support)

Discover cmux localization and internationalization support. Learn how cmux uses String(localized:defaultValue:) and Localizable.xcstrings to ensure seamless global user experiences.

- Tags: architecture
- Published: 2026-03-29

### [How cmux Implements Workspace Persistence Across App Restarts](/manaflow-ai/cmux/how-cmux-implements-workspace-persistence-across-app-restarts)

Discover how cmux ensures workspace persistence across app restarts. Learn how cmux serializes UI state to a JSON file and restores it on launch.

- Tags: internals
- Published: 2026-03-29

### [cmux Debugging Tools: Complete Guide to Development and Testing](/manaflow-ai/cmux/debugging-tools-for-cmux-development)

Master cmux debugging tools with this guide. Explore tagged Unix sockets, ring-buffer logging, and JSON-RPC simulation for efficient development and testing of the terminal multiplexer.

- Tags: how-to-guide
- Published: 2026-03-29

### [How cmux Handles Split Pane Geometry and Resizing in macOS](/manaflow-ai/cmux/how-cmux-handles-split-pane-geometry-and-resizing)

Learn how cmux manages split pane geometry and resizing in macOS. Discover its layout-follow-up system using revision counters to sync logical trees with rendering surfaces.

- Tags: internals
- Published: 2026-03-29

### [Understanding the Relationship Between Panes, Surfaces, and Panels in cmux](/manaflow-ai/cmux/relationship-between-panes-surfaces-and-panels-in-cmux)

Discover the cmux relationship between panes, surfaces, and panels. Understand how these components work together for effective UI management and rendering in this technical guide.

- Tags: internals
- Published: 2026-03-29

### [How to Run Tests Against the cmux Socket API: A Complete Guide](/manaflow-ai/cmux/how-to-run-tests-against-cmux-socket-api)

Master the cmux socket API by launching a Debug build, verifying the Unix socket, and running the Python test suite. Follow our complete guide to test cmux effectively.

- Tags: how-to-guide
- Published: 2026-03-29

### [Performance Considerations for Typing Latency in cmux: Optimizing the Critical Path](/manaflow-ai/cmux/cmux-typing-latency-performance-considerations)

Optimize typing latency in cmux performance. Learn how to keep your main thread free of allocations, I/O, and SwiftUI state churn during keystroke processing.

- Tags: performance
- Published: 2026-03-29

### [How to Use the cmux CLI to Create and Manage Workspaces Programmatically](/manaflow-ai/cmux/how-to-use-cmux-cli-to-create-manage-workspaces-programmatically)

Programmatically create and manage your cmux workspaces using the CLI. Automate workspace operations from external scripts with this guide.

- Tags: how-to-guide
- Published: 2026-03-29

### [Understanding the Structure of cmux v2 JSON Socket Protocol Requests and Responses](/manaflow-ai/cmux/cmux-v2-json-socket-protocol-request-response-structure)

Explore the cmux v2 JSON socket protocol structure. Learn how this JSON-RPC 2.0 style API uses Unix-domain sockets for efficient communication with specific envelope fields.

- Tags: api-reference
- Published: 2026-03-29

### [How cmux Handles Window Focus and Prevents Focus Stealing: A Deep Dive into AppKit and Bonsplit](/manaflow-ai/cmux/how-cmux-handles-window-focus-and-prevents-focus-stealing)

Discover how cmux prevents focus stealing with layered window focus management, AppKit integration, and socket command gating. Learn about its robust safeguards.

- Tags: deep-dive
- Published: 2026-03-29

### [cmux Notification System Architecture: Technical Deep Dive into manaflow-ai/cmux](/manaflow-ai/cmux/architecture-of-cmux-notification-system)

Explore the cmux notification system architecture a three-layer reactive stack. Learn how TerminalNotificationStore bridges CLI commands to SwiftUI with intelligent spam prevention.

- Tags: deep-dive
- Published: 2026-03-29

### [How to Configure cmux to Read an Existing Ghostty Configuration](/manaflow-ai/cmux/how-to-configure-cmux-to-read-existing-ghostty-config)

Effortlessly configure cmux to read your existing Ghostty configuration from standard locations. cmux auto-detects settings for seamless integration without manual steps.

- Tags: how-to-guide
- Published: 2026-03-29

### [How cmux Detects and Handles SSH Sessions for Seamless File Transfers](/manaflow-ai/cmux/how-cmux-detects-and-handles-ssh-sessions)

Learn how cmux detects and handles SSH sessions by scanning TTY for foreground ssh processes and reusing connection parameters for seamless file transfers. Optimize your workflow with cmux.

- Tags: how-to-guide
- Published: 2026-03-29

### [cmux Keyboard Shortcuts for Pane Navigation: Complete Guide to Focus Commands](/manaflow-ai/cmux/cmux-keyboard-shortcuts-for-pane-navigation)

Master cmux keyboard shortcuts for pane navigation. Learn to use ⌘⌥←, ⌘⌥→, ⌘⌥↑, and ⌘⌥↓ to effortlessly switch focus between split panes with this comprehensive guide.

- Tags: how-to-guide
- Published: 2026-03-29

### [How to Script Terminal Splits and Panes Using cmux JSON API](/manaflow-ai/cmux/how-to-script-terminal-splits-and-panes-using-cmux-json-api)

Automate terminal pane creation and layout splits programmatically using the cmux JSON API. Script splits and panes with surface.split and pane.create methods.

- Tags: how-to-guide
- Published: 2026-03-29

### [How Window, Workspace, Pane, and Surface IDs Work in cmux: A Complete Technical Guide](/manaflow-ai/cmux/how-window-workspace-pane-and-surface-ids-work-in-cmux)

Understand cmux window, workspace, pane, and surface IDs. Learn how UUIDs manage UI, persistence, and scripting in this technical guide.

- Tags: deep-dive
- Published: 2026-03-29

### [Best Practices for Using the cmux Socket API to Control Workspaces](/manaflow-ai/cmux/best-practices-using-cmux-socket-api-to-control-workspaces)

Master the cmux socket API to programmatically control terminal workspaces. Learn best practices for creating, querying, and manipulating workspaces while preventing UI disruption. Enhance your automation workflow.

- Tags: best-practices
- Published: 2026-03-29

### [How cmux Handles Notification Rings and Tab Badge Notifications: A Complete Technical Breakdown](/manaflow-ai/cmux/how-cmux-handles-notification-rings-and-tab-badge-notifications)

Discover how cmux syncs notification rings and tab badges using its TerminalNotificationStore for seamless UI updates across your applications. Get the technical breakdown.

- Tags: deep-dive
- Published: 2026-03-29

### [How to Automate Browser Interactions with cmux In-App Browser API](/manaflow-ai/cmux/how-to-automate-browser-interactions-with-cmux-in-app-browser-api)

Automate browser interactions using the cmux in-app browser API. Control WKWebView panels programmatically with CLI commands for native headless automation.

- Tags: how-to-guide
- Published: 2026-03-29

### [cmux v1 vs v2 Socket API Protocols: Key Differences and Migration Guide](/manaflow-ai/cmux/cmux-v1-vs-v2-socket-api-protocols)

Discover the key differences between cmux v1 plain text and v2 JSON-RPC protocols. Learn about authentication, response formats, and migration to v2 for your Unix-domain socket.

- Tags: migration-guide
- Published: 2026-03-29

### [How cmux Integrates with Ghostty Configuration Files and Themes](/manaflow-ai/cmux/how-cmux-integrates-with-ghostty-config-files-and-themes)

Discover how cmux integrates seamlessly with Ghostty configuration files and themes. Learn how cmux uses the GhosttyConfig Swift struct to load settings and style its UI.

- Tags: how-to-guide
- Published: 2026-03-29