How do I install muxy?

Run these in Claude Code: npx -y skills add muxy-app/muxy --agent claude-code. Then prompt normally.

Does muxy auto-invoke its skills?

Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.

Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Development

Plugin

muxy

Lightweight and Memory efficient terminal for Mac built with SwiftUI and libghostty

FLOW.md

muxy-app@muxy-app

GitHub

Plugin Signal73/100Solid

maintained100

capable23

documented100

adopted71

Install

$ npx -y skills add muxy-app/muxy --agent claude-code

Run the curl in your terminal, the rest in Claude Code.

Stats

HTML Bash Swift Git GitHub

+4 tags

Markdown Mermaid iOS Android

2,163

Stars

186

Forks

Active

Maintenance

Swift

Language

MIT

License

5h ago

Last commit

4mo ago

Created

Repo: muxy-app/muxy

In this plugin

2 skills

- muxy-cli
- muxy-extension

See everything inside

What's inside

Skills

/muxy-cliHow to drive the Muxy macOS terminal multiplexer from a shell with the `muxy` command — open projects, switch projects/worktrees/tabs, build split layouts, send input to panes, and read visible terminal output. Use this when you are an agent running inside a Muxy pane (or any /muxy-extensionBest-practice guide for authoring a Muxy extension — how it should look and behave so it reads as a native part of the app. Covers theming (follow the theme, never hardcode colors), the sizing scale, and which surface to use. Mechanics (manifest fields, permissions, the

README

Read on GitHub

Vision

Lightweight terminal that has a rich API for extensions

Screenshots

Features

Project groups
Vertical tabs
Split panes
Git worktrees
Quick open & command palette
Text editor with syntax highlighting
Markdown & HTML preview (with Mermaid diagrams)
Image viewer
Extensions
Mobile companion apps (iOS & Android)
Rich input panel with image attachments
Voice input
Notifications (in-app & native macOS)
490+ themes
50+ customizable shortcuts
Workspace & session persistence
Optional shortcut-triggered quick terminal that expands from the cutout like a dynamic island, with a persistent home-directory shell and configurable glass appearance

Agent Skills

# Drive the workspace from a shell (open projects, splits, send keys, read panes)
npx skills add github.com/muxy-app/muxy/tree/main/Muxy/Resources/skills/muxy-cli

# Author Muxy extensions (manifest, window.muxy API, theming)
npx skills add github.com/muxy-app/muxy/tree/main/Muxy/Resources/skills/muxy-extension

# Or install both into every detected AI harness at once (requires the Muxy CLI)
muxy install-skills

Requirements

macOS 14+
Swift 6.0+

Install

Homebrew

brew tap muxy-app/tap
brew install --cask muxy

Manual

Download the latest release from the releases page

iOS

Instructions

Android

Instructions

Local Development

scripts/setup.sh          # downloads GhosttyKit.xcframework
swift build               # debug build
swift run Muxy             # run
scripts/checks.sh         # format, lint, build, and test in isolated app storage

License

MIT

File tree

1566

muxy-app/muxyView on GitHub

.env.example
.gitattributes
.github/
  copilot-instructions.md
  FUNDING.yml
  ISSUE_TEMPLATE/
    bug_report.yml
    config.yml
    feature_request.yml
  pull_request_template.md
  workflows/
    checks.yml
    notify-discord.yml
    release-beta.yml
    release.yml
    republish-beta-appcast.yml
    update-homebrew-tap.yml
.gitignore
.swiftformat
.swiftlint.yml
.swiftpm/
  xcode/
    xcshareddata/
      xcschemes/
        Muxy.xcscheme
.tool-versions
AGENTS.md
assets/
  logo.svg
BETA_VERSION
CLAUDE.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
docs/
  extensions/
    browser.md
    contributing.md
    dialogs.md
    events.md
    files.md
    get-started.md
    gh.md
    git.md
    http.md
    lifecycle.md
    localizations.md
    logs.md
    manifest.md
    modal.md
    overview.md
    palette-commands.md
    panels.md
    permissions.md
    popovers.md
    remote-methods.md
    schema/
      manifest.schema.json
    scripts.md
    settings.md
    sidebars.md
    statusbar.md
    storage.md
    tabs.md
    topbar.md
  features/
    ai-notifications.md
    muxy-cli.md
    terminal.md
    tips.md
  layouts/
    examples.md
    overview.md
    schema.md
  remote-server/
    data-objects.md
    events.md
    methods.md
    overview.md
    pairing.md
    protocol.md
    setup.md
  user-guide/
    getting-started.md
    settings.md
    troubleshooting.md
GhosttyKit/
  GhosttyKit.c
  module.modulemap
LICENSE
Muxy/
  Commands/
    DiagnosticsMenuController.swift
    MuxyCommands.swift
  Extensions/
    BundleExtension.swift
    DTOConversions.swift
    Notification+Names.swift
    OverlayActiveEnvironment.swift
    View+FocusOnChange.swift
    View+KeyboardShortcut.swift
    WorktreeKeyEnvironment.swift
  Info.plist
  Models/
    Browser/
      BrowserHistoryEntry.swift
      BrowserHomePage.swift
      BrowserLoadError.swift
      BrowserProfile.swift
      BrowserSearchEngine.swift
      BrowserSuggestionModel.swift
      BrowserTabState.swift
      BrowserURL.swift
      BrowserZoom.swift
    Extension/
      Extension.swift
      ExtensionEvent.swift
      ExtensionLifecycle.swift
      ExtensionLocalizationCatalog.swift
      ExtensionPanelState.swift
      ExtensionPopoverState.swift
      ExtensionShortcut.swift
      ExtensionShortcutGroup.swift
      ExtensionTabState.swift
    Input/
      CommandShortcut.swift
      RichInputDraft.swift
      RichInputImageStrategy.swift
      RichInputState.swift
    Keyboard/
      KeyBinding.swift
      KeyCombo.swift
      QuickTerminalShortcut.swift
    Layout/
      AgentsFocusedLayout.swift
      AgentsFocusedTabSelection.swift
      AppLayout.swift
      AppLayoutProviding.swift
      AppLayoutStore.swift
      ProjectFocusedLayout.swift
      PullRequestPresentation.swift
      RepositoryAIActionConfirmation.swift
      RepositoryChangesPresentation.swift
      TabFocusedLayout.swift
      TabFocusedRepositoryState.swift
      TabFocusedSidebarMetrics.swift
      TabFocusedSidebarRowTap.swift
      TabFocusedSidebarState.swift
      TabFocusedSidebarTarget.swift
      TabFocusedTabOrder.swift
    Preferences/
      AppTransparencyPreferences.swift
      BackgroundAppearance.swift
      BrowserPreferences.swift
      ComposerLayoutPreferences.swift
      GeneralSettingsKeys.swift
      HomeProjectPreferences.swift
      NotificationSettings.swift
      ProjectLifecyclePreferences.swift
      ProjectPickerPreferences.swift
      ProjectSearchPreferences.swift
      QuickTerminalAppearancePreferences.swift
      QuickTerminalPreferences.swift
      QuickTerminalSizePreferences.swift
      QuitConfirmationPreferences.swift
      RecordingPreferences.swift
      RepositoryAIActionPreferences.swift
      ResourceUsagePreferences.swift
      RichInputPreferences.swift
      SentryConsent.swift
      TabCloseConfirmationPreferences.swift
      TabWidthPreferences.swift
      TerminalOfflinePreferences.swift
      TerminalPersistentSessionPreferences.swift
      TipsPreferences.swift
      WhatsNewPreferences.swift
      WorktreeListPreferences.swift
    Project/
      CommandTabRequest.swift
      Project.swift
      ProjectGroup.swift
      ProjectNavigationOrder.swift
      ProjectPickerDefaultLocation.swift
      ProjectSortMode.swift
      RecentlyRemovedProject.swift
      RemoteDevice.swift
      Worktree.swift
      WorktreeConfig.swift
      WorktreeKey.swift
      WorktreeLocationSelection.swift
    Shared/
      BackupManifest.swift
      ProcessUsage.swift
    Terminal/
      TerminalActivity.swift
      TerminalControlBytes.swift
      TerminalOfflineTimeout.swift
      TerminalOmniboxItem.swift
      TerminalPaneState.swift
      TerminalProgress.swift
      TerminalSearchState.swift
      TerminalTab.swift
    UI/
      AppBackgroundStyle.swift
      FileOpenerSelection.swift
      LocalizationSelection.swift
      MuxyNotification.swift
      MuxyTip.swift
      NavigationHistory.swift
      Panel.swift
      SidebarMode.swift
      SidebarSelection.swift
      ToastState.swift
    Workspace/
      AppState.swift
      LayoutConfig.swift
      LayoutWorkspaceBuilder.swift
      Reducer/
        FocusReducer.swift
        ProjectLifecycleReducer.swift
        SplitReducer.swift
        TabReducer.swift
        TopLevelTabReducer.swift
        WorkspaceReducerShared.swift
      SplitNode.swift
      TabArea.swift
      TabDragCoordinator.swift
      TopLevelTabNode.swift
      WorkspaceReducer.swift
      WorkspaceSnapshot.swift
  Muxy.entitlements
  MuxyApp.swift
  Resources/
    Assets.xcassets/
      AppIcon.appiconset/
        Contents.json
        icon_128.png
        icon_128@2x.png
        icon_16.png
        icon_16@2x.png
        icon_256.png
        icon_256@2x.png
        icon_32.png
        icon_32@2x.png
        icon_512.png
        icon_512@2x.png
      Contents.json
    ghostty/
    ghostty-overrides/
      transparent-surface.conf
      themes/
        0x96f
        12-bit Rainbow
        3024 Day
        3024 Night
        Aardvark Blue
        Abernathy
        Adventure
        Adventure Time
        Adwaita
        Adwaita Dark
        Afterglow
        Aizen Dark
        Aizen Light
        Alabaster
        Alien Blood
        Andromeda
        Apple Classic
        Apple System Colors
        Apple System Colors Light
        Arcoiris
        Ardoise
        Argonaut
        Arthur
        Atelier Sulphurpool
        Atom
        Atom One Dark
        Atom One Light
        Aura
        Aurora
        Ayu
        Ayu Light
        Ayu Mirage
        Banana Blueberry
        Batman
        Belafonte Day
        Belafonte Night
        Birds Of Paradise
        Black Metal
        Black Metal (Bathory)
        Black Metal (Burzum)
        Black Metal (Dark Funeral)
        Black Metal (Gorgoroth)
        Black Metal (Immortal)
        Black Metal (Khold)
        Black Metal (Marduk)
        Black Metal (Mayhem)
        Black Metal (Nile)
        Black Metal (Venom)
        Blazer
        Blue Berry Pie
        Blue Dolphin
        Blue Matrix
        Bluloco Dark
        Bluloco Light
        Borland
        Box
        branch
        Breadog
        Breeze
        Bright Lights
        Broadcast
        Brogrammer
        Builtin Dark
        Builtin Light
        Builtin Pastel Dark
        Builtin Tango Dark
        Builtin Tango Light
        C64
        Calamity
        Carbonfox
        Catppuccin Frappe
        Catppuccin Latte
        Catppuccin Macchiato
        Catppuccin Mocha
        CGA
        Chalk
        Chalkboard
        Challenger Deep
        Chester
        Ciapre
        Citruszest
        Claude
        Claude Light
        CLRS
        Cobalt Neon
        Cobalt Next
        Cobalt Next Dark
        Cobalt Next Minimal
        Cobalt2
        Coffee Theme
        Crayon Pony Fish
        Cursor Dark
        Cursor Light
        Cutie Pro
        Cyberdyne
        Cyberpunk
        Cyberpunk Scarlet Protocol
        Dalton Dark
        Dark Modern
        Dark Pastel
        Dark+
        Darkermatrix
        Darkmatrix
        Darkside
        Dawnfox
        Dayfox
        Deep
        Desert
        Detuned
        Dimidium
        Dimmed Monokai
        Django
        Django Reborn Again
        Django Smooth
        Dogxi Misty
        Doom One
        Doom Peacock
        Dot Gov
        Dracula
        Dracula+
        Duckbones
        Duotone Dark
        Duskfox
        Earthsong
        Electron Highlighter
        Elegant
        Elemental
        Elementary
        Embark
        Embers Dark
        ENCOM
        Espresso
        Espresso Libre
        Everblush
        Everforest Dark Hard
        Everforest Light Med
        Fahrenheit
        Fairyfloss
        Farmhouse Dark
        Farmhouse Light
        Fideloper
        Firefly Traditional
        Firefox Dev
        Firewatch
        Fish Tank
        Flat
        Flatland
        Flexoki Dark
        Flexoki Light
        Floraverse
... 1348 more

FAQ

muxy is a Claude Code plugin with 2 hand-picked skills for development work, indexed on Flowy. Install it with the command on its page. It includes muxy-cli, muxy-extension. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.

What is muxy?: Lightweight and Memory efficient terminal for Mac built with SwiftUI and libghostty
How do I install muxy?: Run these in Claude Code: npx -y skills add muxy-app/muxy --agent claude-code. Then prompt normally.
Does muxy auto-invoke its skills?: Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
Is muxy free?: Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.

Features

Project groups

Vertical tabs

Split panes

Git worktrees

Quick open & command palette

Text editor with syntax highlighting

Markdown & HTML preview (with Mermaid diagrams)

Image viewer

Extensions

Mobile companion apps (iOS & Android)

Rich input panel with image attachments

Voice input

Notifications (in-app & native macOS)

490+ themes

50+ customizable shortcuts

Workspace & session persistence

Optional shortcut-triggered quick terminal that expands from the cutout like a dynamic island, with a persistent home-directory shell and configurable glass appearance

Agent Skills

# Drive the workspace from a shell (open projects, splits, send keys, read panes) npx skills add github.com/muxy-app/muxy/tree/main/Muxy/Resources/skills/muxy-cli # Author Muxy extensions (manifest, window.muxy API, theming) npx skills add github.com/muxy-app/muxy/tree/main/Muxy/Resources/skills/muxy-extension # Or install both into every detected AI harness at once (requires the Muxy CLI) muxy install-skills

scripts/setup.sh # downloads GhosttyKit.xcframework swift build # debug build swift run Muxy # run scripts/checks.sh # format, lint, build, and test in isolated app storage

.env.example .gitattributes .github/ copilot-instructions.md FUNDING.yml ISSUE_TEMPLATE/ bug_report.yml config.yml feature_request.yml pull_request_template.md workflows/ checks.yml notify-discord.yml release-beta.yml release.yml republish-beta-appcast.yml update-homebrew-tap.yml .gitignore .swiftformat .swiftlint.yml .swiftpm/ xcode/ xcshareddata/ xcschemes/ Muxy.xcscheme .tool-versions AGENTS.md assets/ logo.svg BETA_VERSION CLAUDE.md CODE_OF_CONDUCT.md CONTRIBUTING.md docs/ extensions/ browser.md contributing.md dialogs.md events.md files.md get-started.md gh.md git.md http.md lifecycle.md localizations.md logs.md manifest.md modal.md overview.md palette-commands.md panels.md permissions.md popovers.md remote-methods.md schema/ manifest.schema.json scripts.md settings.md sidebars.md statusbar.md storage.md tabs.md topbar.md features/ ai-notifications.md muxy-cli.md terminal.md tips.md layouts/ examples.md overview.md schema.md remote-server/ data-objects.md events.md methods.md overview.md pairing.md protocol.md setup.md user-guide/ getting-started.md settings.md troubleshooting.md GhosttyKit/ GhosttyKit.c module.modulemap LICENSE Muxy/ Commands/ DiagnosticsMenuController.swift MuxyCommands.swift Extensions/ BundleExtension.swift DTOConversions.swift Notification+Names.swift OverlayActiveEnvironment.swift View+FocusOnChange.swift View+KeyboardShortcut.swift WorktreeKeyEnvironment.swift Info.plist Models/ Browser/ BrowserHistoryEntry.swift BrowserHomePage.swift BrowserLoadError.swift BrowserProfile.swift BrowserSearchEngine.swift BrowserSuggestionModel.swift BrowserTabState.swift BrowserURL.swift BrowserZoom.swift Extension/ Extension.swift ExtensionEvent.swift ExtensionLifecycle.swift ExtensionLocalizationCatalog.swift ExtensionPanelState.swift ExtensionPopoverState.swift ExtensionShortcut.swift ExtensionShortcutGroup.swift ExtensionTabState.swift Input/ CommandShortcut.swift RichInputDraft.swift RichInputImageStrategy.swift RichInputState.swift Keyboard/ KeyBinding.swift KeyCombo.swift QuickTerminalShortcut.swift Layout/ AgentsFocusedLayout.swift AgentsFocusedTabSelection.swift AppLayout.swift AppLayoutProviding.swift AppLayoutStore.swift ProjectFocusedLayout.swift PullRequestPresentation.swift RepositoryAIActionConfirmation.swift RepositoryChangesPresentation.swift TabFocusedLayout.swift TabFocusedRepositoryState.swift TabFocusedSidebarMetrics.swift TabFocusedSidebarRowTap.swift TabFocusedSidebarState.swift TabFocusedSidebarTarget.swift TabFocusedTabOrder.swift Preferences/ AppTransparencyPreferences.swift BackgroundAppearance.swift BrowserPreferences.swift ComposerLayoutPreferences.swift GeneralSettingsKeys.swift HomeProjectPreferences.swift NotificationSettings.swift ProjectLifecyclePreferences.swift ProjectPickerPreferences.swift ProjectSearchPreferences.swift QuickTerminalAppearancePreferences.swift QuickTerminalPreferences.swift QuickTerminalSizePreferences.swift QuitConfirmationPreferences.swift RecordingPreferences.swift RepositoryAIActionPreferences.swift ResourceUsagePreferences.swift RichInputPreferences.swift SentryConsent.swift TabCloseConfirmationPreferences.swift TabWidthPreferences.swift TerminalOfflinePreferences.swift TerminalPersistentSessionPreferences.swift TipsPreferences.swift WhatsNewPreferences.swift WorktreeListPreferences.swift Project/ CommandTabRequest.swift Project.swift ProjectGroup.swift ProjectNavigationOrder.swift ProjectPickerDefaultLocation.swift ProjectSortMode.swift RecentlyRemovedProject.swift RemoteDevice.swift Worktree.swift WorktreeConfig.swift WorktreeKey.swift WorktreeLocationSelection.swift Shared/ BackupManifest.swift ProcessUsage.swift Terminal/ TerminalActivity.swift TerminalControlBytes.swift TerminalOfflineTimeout.swift TerminalOmniboxItem.swift TerminalPaneState.swift TerminalProgress.swift TerminalSearchState.swift TerminalTab.swift UI/ AppBackgroundStyle.swift FileOpenerSelection.swift LocalizationSelection.swift MuxyNotification.swift MuxyTip.swift NavigationHistory.swift Panel.swift SidebarMode.swift SidebarSelection.swift ToastState.swift Workspace/ AppState.swift LayoutConfig.swift LayoutWorkspaceBuilder.swift Reducer/ FocusReducer.swift ProjectLifecycleReducer.swift SplitReducer.swift TabReducer.swift TopLevelTabReducer.swift WorkspaceReducerShared.swift SplitNode.swift TabArea.swift TabDragCoordinator.swift TopLevelTabNode.swift WorkspaceReducer.swift WorkspaceSnapshot.swift Muxy.entitlements MuxyApp.swift Resources/ Assets.xcassets/ AppIcon.appiconset/ Contents.json icon_128.png icon_128@2x.png icon_16.png icon_16@2x.png icon_256.png icon_256@2x.png icon_32.png icon_32@2x.png icon_512.png icon_512@2x.png Contents.json ghostty/ ghostty-overrides/ transparent-surface.conf themes/ 0x96f 12-bit Rainbow 3024 Day 3024 Night Aardvark Blue Abernathy Adventure Adventure Time Adwaita Adwaita Dark Afterglow Aizen Dark Aizen Light Alabaster Alien Blood Andromeda Apple Classic Apple System Colors Apple System Colors Light Arcoiris Ardoise Argonaut Arthur Atelier Sulphurpool Atom Atom One Dark Atom One Light Aura Aurora Ayu Ayu Light Ayu Mirage Banana Blueberry Batman Belafonte Day Belafonte Night Birds Of Paradise Black Metal Black Metal (Bathory) Black Metal (Burzum) Black Metal (Dark Funeral) Black Metal (Gorgoroth) Black Metal (Immortal) Black Metal (Khold) Black Metal (Marduk) Black Metal (Mayhem) Black Metal (Nile) Black Metal (Venom) Blazer Blue Berry Pie Blue Dolphin Blue Matrix Bluloco Dark Bluloco Light Borland Box branch Breadog Breeze Bright Lights Broadcast Brogrammer Builtin Dark Builtin Light Builtin Pastel Dark Builtin Tango Dark Builtin Tango Light C64 Calamity Carbonfox Catppuccin Frappe Catppuccin Latte Catppuccin Macchiato Catppuccin Mocha CGA Chalk Chalkboard Challenger Deep Chester Ciapre Citruszest Claude Claude Light CLRS Cobalt Neon Cobalt Next Cobalt Next Dark Cobalt Next Minimal Cobalt2 Coffee Theme Crayon Pony Fish Cursor Dark Cursor Light Cutie Pro Cyberdyne Cyberpunk Cyberpunk Scarlet Protocol Dalton Dark Dark Modern Dark Pastel Dark+ Darkermatrix Darkmatrix Darkside Dawnfox Dayfox Deep Desert Detuned Dimidium Dimmed Monokai Django Django Reborn Again Django Smooth Dogxi Misty Doom One Doom Peacock Dot Gov Dracula Dracula+ Duckbones Duotone Dark Duskfox Earthsong Electron Highlighter Elegant Elemental Elementary Embark Embers Dark ENCOM Espresso Espresso Libre Everblush Everforest Dark Hard Everforest Light Med Fahrenheit Fairyfloss Farmhouse Dark Farmhouse Light Fideloper Firefly Traditional Firefox Dev Firewatch Fish Tank Flat Flatland Flexoki Dark Flexoki Light Floraverse ... 1348 more