Skip to content
Back to search

mori

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/vaayne--mori/badge.svg)](/listings/vaayne--mori)

HTML

<a href="/listings/vaayne--mori"><img src="/api/listings/vaayne--mori/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

brew tap vaayne/tap
brew install --cask mori

Or download from [GitHub Releases](https://github.com/vaayne/mori/releases). MoriRemote for iOS is on [TestFlight](https://testflight.apple.com/join/k2GFJPC2).

MoriRemote

MoriRemote is an iPhone/iPad SSH and tmux companion, not a remote desktop. It uses explicit host-key confirmation, supports passwords or imported OpenSSH private keys, and keeps mobile navigation isolated from other tmux clients. It requires tmux 3.2 or newer on the server. Local terminal history and selection stay on the device; split, close, and new-window actions are shared workspace mutations. The software keyboard supports IME composition. Images chosen from Photos or the clipboard are uploaded through the authenticated SSH connection, then inserted as a shell-escaped remote path without auto-submit.

Building MoriRemote from source requires Xcode, XcodeGen, and the pinned remux Ghostty source. The local task builds one universal macOS + iOS XCFramework; CI builds the same source once and shares that artifact with macOS and iOS jobs.

mise run ios:test
mise run ios:run                         # verifies launch, liveness, crash logs, screenshots

The framework is built from `h3nock/remux-ghostty` at the pinned source commit, not downloaded from a third-party prebuilt artifact. See [`MoriRemote/UPSTREAM.md`](MoriRemote/UPSTREAM.md).

<details> <summary>Build from source</summary>

Requires macOS 14+, tmux, [mise](https://mise.jdx.dev/), Zig 0.15.2, and Xcode.

mise run build    # Debug build (bootstraps macOS libghostty automatically)
# `mise run ios:*` bootstraps the universal macOS + iOS GhosttyKit artifact
mise run dev      # Build + run
mise run test     # Run all tests

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 130 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="assets/banner.svg" alt="Mori" width="600">
  3. </p>
  4. <p align="center">
  5. <b>English</b> | <a href="README.zh-Hans.md">中文</a>
  6. </p>
  7. Mori is a macOS terminal built for developers who work across multiple git branches at the same time. Instead of juggling anonymous tabs or losing tmux state between context switches, Mori gives each branch its own persistent environment — and keeps them all one click away in a sidebar.
  8. ## Screenshots
  9. | Light | Dark | Lazygit | Yazi | Settings |
  10. |---|---|---|---|---|
  11. | ![](docs/screenshots/light-mode.jpeg) | ![](docs/screenshots/dark-mode.jpeg) | ![](docs/screenshots/lazygit.png) | ![](docs/screenshots/yazi.jpeg) | ![](docs/screenshots/settings.jpeg) |
  12. ## Features
  13. - **One sidebar, every branch** — your projects and worktrees are always one click away; no anonymous tabs to lose track of
  14. - **Sessions that outlive the app** — close Mori, reopen it tomorrow; tmux keeps every process running exactly where you left it
  15. - **True branch isolation** — each worktree gets its own directory and tmux session; run `main` and `feat/auth` side-by-side without interference
  16. - **Local + SSH** — connect local repos or remote servers; the native Mac UI works either way
  17. - **GPU-rendered terminal** — Ghostty's libghostty engine with Metal acceleration
  18. - **Terminal drag-and-drop** — drop files, URLs, or text to insert shell-ready paths and content
  19. - **CLI + agent-ready** — `mori` CLI exposes everything over a Unix socket; built for scripting and AI agent workflows
  20. - **MoriRemote** — iPhone/iPad companion for SSH/tmux access when away from your Mac
  21. ## The mental model
  22. Mori maps your development hierarchy onto tmux. Each git worktree becomes a tmux session; each session holds windows (tabs) and panes (splits). Close the app, come back tomorrow — everything is still running.
  23. ```
  24. Project (git repo)
  25. └── Worktree (branch) ← tmux session e.g. myapp/feat-auth
  26. ├── Window (tab) ← tmux window e.g. "shell"
  27. │ ├── Pane (split left) ← tmux pane
  28. │ └── Pane (split right) ← tmux pane
  29. └── Window (tab) ← tmux window e.g. "logs"
  30. └── Pane
  31. ```
  32. - **Project** — a git repository tracked by root path and short name.
  33. - **Worktree** — a `git worktree` checkout; gets its own directory and tmux session (`<project>/<branch>`).
  34. - **Window** — a tmux window inside the session. Equivalent to a tab.
  35. - **Pane** — a tmux pane inside a window. Equivalent to a split.
  36. The sidebar lists your projects and worktrees. Click one to attach. Switching is instant — you never lose what was running.
  37. ## Install
  38. ```bash
  39. brew tap vaayne/tap
  40. brew install --cask mori
  41. ```
  42. Or download from [GitHub Releases](https://github.com/vaayne/mori/releases). MoriRemote for iOS is on [TestFlight](https://testflight.apple.com/join/k2GFJPC2).
  43. ### MoriRemote
  44. MoriRemote is an iPhone/iPad SSH and tmux companion, not a remote desktop. It
  45. uses explicit host-key confirmation, supports passwords or imported OpenSSH
  46. private keys, and keeps mobile navigation isolated from other tmux clients.
  47. It requires tmux 3.2 or newer on the server. Local terminal history and
  48. selection stay on the device; split, close, and new-window actions are shared
  49. workspace mutations. The software keyboard supports IME composition. Images
  50. chosen from Photos or the clipboard are uploaded through the authenticated SSH
  51. connection, then inserted as a shell-escaped remote path without auto-submit.
  52. Building MoriRemote from source requires Xcode, XcodeGen, and the pinned remux
  53. Ghostty source. The local task builds one universal macOS + iOS XCFramework;
  54. CI builds the same source once and shares that artifact with macOS and iOS jobs.
  55. ```bash
  56. mise run ios:test
  57. mise run ios:run # verifies launch, liveness, crash logs, screenshots
  58. ```
  59. The framework is built from `h3nock/remux-ghostty` at the pinned source commit,
  60. not downloaded from a third-party prebuilt artifact. See
  61. [`MoriRemote/UPSTREAM.md`](MoriRemote/UPSTREAM.md).
  62. <details>
  63. <summary>Build from source</summary>
  64. Requires macOS 14+, tmux, [mise](https://mise.jdx.dev/), Zig 0.15.2, and Xcode.
  65. ```bash
  66. mise run build # Debug build (bootstraps macOS libghostty automatically)
  67. # `mise run ios:*` bootstraps the universal macOS + iOS GhosttyKit artifact
  68. mise run dev # Build + run
  69. mise run test # Run all tests
  70. ```
  71. </details>
  72. ## CLI
  73. The `mori` CLI communicates with the running app over a Unix socket, auto-launching Mori if needed. Address flags default to `MORI_*` environment variables set in every pane — inside a session you can omit them entirely.
  74. ```bash
  75. mori project open . # register current directory as a project
  76. mori worktree new feat/auth --project myapp # create git worktree + tmux session
  77. mori pane read --lines 100 # capture pane output (great for agents)
  78. mori focus --project myapp --worktree feat/auth # switch to a worktree instantly
  79. ```
  80. All commands accept `--json` for machine-readable output. See [docs/cli-redesign.md](docs/cli-redesign.md) for the full reference.
  81. ## Terminal Configuration
  82. 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).
  83. For Mori-managed tmux sessions, Mori also applies a small tmux preset by default to speed up onboarding: mouse support on, status bar off. You can turn that off in **Settings → Tools** if you prefer to keep your own mouse and status-bar behavior from `tmux.conf` instead.
  84. ## Keyboard Shortcuts
  85. See [docs/keymaps.md](docs/keymaps.md) for the full list. Key highlights:
  86. | Shortcut | Action |
  87. |---|---|
  88. | <kbd>⌘</kbd>+<kbd>T</kbd> | New window (tab) |
  89. | <kbd>⌘</kbd>+<kbd>D</kbd> / <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>D</kbd> | Split right / down |
  90. | <kbd>⌃</kbd>+<kbd>Tab</kbd> | Cycle worktrees |
  91. | <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>N</kbd> | New worktree |
  92. | <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>P</kbd> | Command palette |
  93. | <kbd>⌘</kbd>+<kbd>G</kbd> | Lazygit |
  94. | <kbd>⌘</kbd>+<kbd>E</kbd> | Yazi |
  95. ## License
  96. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.