Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

cmux-ghostty — Claude Code skill: what it does, how to install

Enforces workflow guidelines for the Ghostty submodule and GhosttyKit compilation in cmux. Useful when syncing the fork or committing submodule pointers.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add manaflow-ai/cmux --skill cmux-ghostty -a claude-code
Open on GitHub

What cmux-ghostty does

This skill defines exact rules for touching the ghostty submodule in the cmux codebase. It instructs agents to compile GhosttyKit.xcframework using Zig with ReleaseFast optimization for universal targets. It also demands updating docs/ghostty-fork.md whenever fork modifications or merge conflicts occur.

Its core rule prevents broken parent repository references. You must push your submodule commits to the remote fork branch before updating the pointer in cmux. Committing on a detached HEAD breaks CI runs for other developers because the remote cannot fetch missing commits. The skill provides git merge-base inspection commands to verify commit reachability before committing to the parent project.

What it helps with

  • compile GhosttyKit.xcframework with universal Zig release build
  • sync the ghostty submodule fork with ghostty-org upstream
  • verify submodule commit reachability before updating parent pointers
  • document conflict notes in docs/ghostty-fork.md

Example prompts for the agent

  • Rebuild GhosttyKit.xcframework for cmux with release flags
  • Pull the latest upstream commits from ghostty-org into our fork
  • Verify the ghostty submodule pointer before committing in cmux

How to install cmux-ghostty

1Skills CLI (Vercel)

npx skills add manaflow-ai/cmux --skill cmux-ghostty -a claude-code

2Manually: put the files in place

~/.claude/skills/cmux-ghostty/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/cmux-ghostty/

From the same set12

The whole set →
cmux manaflow-ai Skill for navigating multi-pane cmux layouts: create windows, workspaces, splits, focus surfaces, and move terminals and browser panels without breaking automation. Use it when an agent needs deterministic placement and routing. Claude Code CX Codex Cursor +1 9,600installs cmux-browser manaflow-ai Automates browser surfaces via the cmux CLI without stealing user focus. Useful for background page inspections, waiting on selectors, and form fills. Claude Code CX Codex Cursor +1 8,800installs cmux-customization manaflow-ai Configures the cmux workspace manager: edits cmux.json, wires Command Palette actions, sets dock terminals, and routes terminal-level styling directly to Ghostty. Claude Code CX Codex Cursor +1 6,600installs cmux-diagnostics manaflow-ai Skill runs read-only cmux diagnostics: sockets, hooks, session restore, settings. Use when notifications fail, agents don't resume, or you need a support-safe debug report. Claude Code CX Codex Cursor +1 6,400installs cmux-keyboard-shortcuts manaflow-ai Configures cmux shortcuts in ~/.config/cmux/cmux.json. Useful for adopting tmux-style chords, auditing overrides, and validating syntax. Claude Code CX Codex Cursor +1 6,200installs cmux-testing manaflow-ai Skill for choosing verification scopes, adding tests, and validating Swift test targets in the cmux project. Decides what local and CI evidence a change needs. Claude Code CX Codex Cursor +1 4,900installs cmux-custom-sidebar manaflow-ai Skill for writing a custom cmux sidebar in a SwiftUI-like language. The sidebar binds to workspaces, tabs, PRs, and clock; hot-reloads on save; runs cmux commands on tap. Claude Code CX Codex Cursor +1 4,800installs cmux-architecture manaflow-ai Guides modular Swift package architecture, strict 5-layer dependency inversion, and Swift 6 concurrency rules in the cmux codebase. Claude Code CX Codex Cursor +1 4,800installs

Similar

changelog-automation Seth Hobson This skill helps generate changelogs and release notes from commits, PRs, and releases. Use it when setting up release workflows or shared commit rules. Claude Code CX Codex Cursor 13,733installs receipts official Anthropic Generates a personal Claude Code activity report from local session transcripts — for justifying spend to a manager or self-review. Claude Code 2,052installs secret-scanning official github This skill guides GitHub secret scanning, push protection, custom patterns, and alert remediation. Use it when a repository needs secret checks before commits or pushes. GitHub Copilot 4,600installs dependabot official github A GitHub Copilot skill that helps write and tune .github/dependabot.yml: grouped updates, monorepo patterns, security updates. GitHub Copilot 4,400installs copilot-spaces official github Pulls Copilot Spaces content into the conversation: team docs, code and instructions. Useful when answers must follow internal standards instead of the model's general knowledge. GitHub Copilot 4,400installs context-driven-development Seth Hobson This skill keeps project context in conductor/, creates and checks its documents, and syncs them as work changes. Use it for setup or codebase onboarding. Claude Code CX Codex Cursor 11,099installs triage Matt Pocock This skill moves issues and external PRs through triage states, verification, and agent briefs. It fits maintainers managing an issue queue. Claude Code 990,453installs code-review Matt Pocock Reviews changes from a chosen reference point against repository standards and the originating spec. Use it for a branch, PR, or work in progress. Claude Code 789,521installs

Questions about cmux-ghostty

How to install cmux-ghostty in Claude Code?

Run the command npx skills add manaflow-ai/cmux --skill cmux-ghostty -a claude-code. You can also place the skill file manually at ~/.claude/skills/cmux-ghostty/SKILL.md.

What does the cmux-ghostty skill do?

It outlines standard steps for rebuilding GhosttyKit and safely committing Git submodule changes. It applies to ghostty, vendor/bonsplit, and homebrew-cmux.

What tool builds GhosttyKit.xcframework?

The framework requires Zig, compiling with flags -Demit-xcframework=true, -Dxcframework-target=universal, and -Doptimize=ReleaseFast.

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor