.github
.swiftpm
assets
docs
GhosttyKit
Muxy
MuxyExtensionHost
MuxyHookBridge
MuxyHookKit
MuxyServer
MuxySession
MuxySessionProtocol
MuxyShared
scripts
Tests
.env.example
.gitattributes
.gitignore
.swiftformat
.swiftlint.yml
.tool-versions
AGENTS.md
BETA_VERSION
CLAUDE.md
CODE_OF_CONDUCT.md
CONTRIBUTING.md
LICENSE
Package.resolved
Package.swift
PRIVACY.md
README.md
SECURITY.md
skills-lock.json
Muxy
Lightweight and Memory efficient terminal for Mac built with SwiftUI and libghostty.
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-skillsRequirements
- macOS 14+
- Swift 6.0+
Install
Homebrew
brew tap muxy-app/tap
brew install --cask muxyManual
Download the latest release from the releases page
iOS
Android
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