cmux

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

23 articles

Common Issues with Nested Split Layouts in cmux: Focus, Drift, and Ordering Fixes

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.

deep-dive

Mar 29, 2026

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.

how-to-guide

Mar 29, 2026

Localization and Internationalization Support in cmux: Architecture and Implementation

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

architecture

Mar 29, 2026

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.

internals

Mar 29, 2026

cmux Debugging Tools: Complete Guide to Development and Testing

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.

how-to-guide

Mar 29, 2026

How cmux Handles Split Pane Geometry and Resizing in macOS

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.

internals

Mar 29, 2026

Understanding the 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.

internals

Mar 29, 2026

How to Run Tests Against the cmux Socket API: A Complete Guide

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.

how-to-guide

Mar 29, 2026

Performance Considerations for Typing Latency in cmux: Optimizing the Critical Path

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.

performance

Mar 29, 2026

How to Use the cmux CLI to Create and Manage Workspaces Programmatically

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

how-to-guide

Mar 29, 2026

Understanding the Structure of cmux v2 JSON Socket Protocol Requests and Responses

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.

api-reference

Mar 29, 2026

How cmux Handles Window Focus and Prevents Focus Stealing: A Deep Dive into AppKit and Bonsplit

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

deep-dive

Mar 29, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how manaflow-ai/cmux works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →