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.
Badge for your README
Markdown
[](/listings/vaayne--mori)HTML
<a href="/listings/vaayne--mori"><img src="/api/listings/vaayne--mori/badge.svg" alt="findsafeskills safety rating" /></a>Install
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)
- <p align="center">
- <img src="assets/banner.svg" alt="Mori" width="600">
- </p>
- <p align="center">
- <b>English</b> | <a href="README.zh-Hans.md">中文</a>
- </p>
- 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.
- ## Screenshots
- | Light | Dark | Lazygit | Yazi | Settings |
- |---|---|---|---|---|
- |  |  |  |  |  |
- ## Features
- - **One sidebar, every branch** — your projects and worktrees are always one click away; no anonymous tabs to lose track of
- - **Sessions that outlive the app** — close Mori, reopen it tomorrow; tmux keeps every process running exactly where you left it
- - **True branch isolation** — each worktree gets its own directory and tmux session; run `main` and `feat/auth` side-by-side without interference
- - **Local + SSH** — connect local repos or remote servers; the native Mac UI works either way
- - **GPU-rendered terminal** — Ghostty's libghostty engine with Metal acceleration
- - **Terminal drag-and-drop** — drop files, URLs, or text to insert shell-ready paths and content
- - **CLI + agent-ready** — `mori` CLI exposes everything over a Unix socket; built for scripting and AI agent workflows
- - **MoriRemote** — iPhone/iPad companion for SSH/tmux access when away from your Mac
- ## The mental model
- 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.
- ```
- Project (git repo)
- └── Worktree (branch) ← tmux session e.g. myapp/feat-auth
- ├── Window (tab) ← tmux window e.g. "shell"
- │ ├── Pane (split left) ← tmux pane
- │ └── Pane (split right) ← tmux pane
- └── Window (tab) ← tmux window e.g. "logs"
- └── Pane
- ```
- - **Project** — a git repository tracked by root path and short name.
- - **Worktree** — a `git worktree` checkout; gets its own directory and tmux session (`<project>/<branch>`).
- - **Window** — a tmux window inside the session. Equivalent to a tab.
- - **Pane** — a tmux pane inside a window. Equivalent to a split.
- The sidebar lists your projects and worktrees. Click one to attach. Switching is instant — you never lose what was running.
- ## Install
- ```bash
- 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.
- ```bash
- 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.
- ```bash
- 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>
- ## CLI
- 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.
- ```bash
- mori project open . # register current directory as a project
- mori worktree new feat/auth --project myapp # create git worktree + tmux session
- mori pane read --lines 100 # capture pane output (great for agents)
- mori focus --project myapp --worktree feat/auth # switch to a worktree instantly
- ```
- All commands accept `--json` for machine-readable output. See [docs/cli-redesign.md](docs/cli-redesign.md) for the full reference.
- ## Terminal Configuration
- 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).
- 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.
- ## Keyboard Shortcuts
- See [docs/keymaps.md](docs/keymaps.md) for the full list. Key highlights:
- | Shortcut | Action |
- |---|---|
- | <kbd>⌘</kbd>+<kbd>T</kbd> | New window (tab) |
- | <kbd>⌘</kbd>+<kbd>D</kbd> / <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>D</kbd> | Split right / down |
- | <kbd>⌃</kbd>+<kbd>Tab</kbd> | Cycle worktrees |
- | <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>N</kbd> | New worktree |
- | <kbd>⌘</kbd>+<kbd>⇧</kbd>+<kbd>P</kbd> | Command palette |
- | <kbd>⌘</kbd>+<kbd>G</kbd> | Lazygit |
- | <kbd>⌘</kbd>+<kbd>E</kbd> | Yazi |
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.