English | 中文

A native macOS workspace terminal organized around Projects and Worktrees, powered by tmux and libghostty.

Instead of managing loose terminal tabs, Mori treats your git repositories as first-class projects. Each worktree (branch checkout) gets its own persistent tmux session with multiple windows and panes — all presented through a native sidebar and GPU-accelerated terminal.

• Project-first navigation — switch between repos and branches, not anonymous tabs
• Local + remote projects — add local folders or SSH-hosted repositories from one Add flow
• Persistent sessions — close the app, reopen later, everything is still running in tmux
• Native macOS experience — sidebar, command palette, notifications, keyboard shortcuts
• GPU-rendered terminal — libghostty (Ghostty's rendering engine) with Metal acceleration
• Worktree-aware — multiple branches of the same repo run side-by-side with independent sessions

Project (git repo)
  └─ Worktree (branch checkout)
       └─ tmux Session
            ├─ Window (tab)   →  Pane
            ├─ Window         →  Pane | Pane
            └─ Window         →  Pane

Each worktree maps to one tmux session. Windows and panes are standard tmux constructs. Mori provides the UI layer on top — organizing, navigating, and displaying status.

App (AppKit shell + SwiftUI sidebar views)
  ├─ MoriCore         — Models + observable app state
  ├─ MoriUI           — SwiftUI sidebar views
  ├─ MoriTmux         — tmux CLI integration (actor)
  ├─ MoriGit          — Git worktree/status discovery (actor)
  ├─ MoriTerminal     — libghostty terminal surface
  ├─ MoriPersistence  — SQLite via GRDB
  └─ MoriIPC          — Unix socket IPC + `ws` CLI

• macOS 14 (Sonoma) or later
• tmux
• mise (task runner)
• Zig 0.15.2 + Xcode (for building libghostty)

brew tap vaayne/tap
brew install --cask mori

Download the latest release from GitHub Releases.

• .dmg: Open the disk image and move Mori.app into /Applications
• .zip: Extract the archive and move Mori.app into /Applications

The Homebrew tap installs Mori.app. Release bundles also embed the mori CLI for Homebrew-based installs, and the cask declares tmux as a dependency.

mise run build           # Debug build
mise run build:release   # Release build
mise run dev             # Build + run
mise run test            # Run all tests
mise run clean           # Clean build artifacts

mise run build and mise run build:release automatically bootstrap the libghostty XCFramework on first run. You can also build it manually:

mise run build:ghostty   # Requires Zig 0.15.2 + Xcode (downloads Metal Toolchain if missing)

The mori command lets you interact with Mori from the terminal:

mori project list
mori open /path/to/repo
mori worktree create <project> <branch>
mori focus <project> <worktree>
mori send <project> <worktree> <window> "command"
mori new-window <project> <worktree> <name>
mori pane list
mori pane read <project> <worktree> <window> [--lines N]
mori pane message <project> <worktree> <window> "text"
mori pane id

Mori uses Ghostty's configuration system. Customize your terminal in ~/.config/ghostty/config. Mori only overrides a few embedding-specific settings (no window decorations, no quit-on-last-window).

See docs/worktrees.md for worktree management and docs/keymaps.md for the full shortcut list. Highlights:

MIT