{"id":47770679,"url":"https://github.com/vaayne/mori","last_synced_at":"2026-04-16T04:03:32.113Z","repository":{"id":345512584,"uuid":"1186134738","full_name":"vaayne/mori","owner":"vaayne","description":"A native macOS workspace terminal organized around Projects and Worktrees, powered by tmux and libghostty","archived":false,"fork":false,"pushed_at":"2026-04-03T07:20:33.000Z","size":12200,"stargazers_count":169,"open_issues_count":3,"forks_count":12,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-04-03T13:58:10.510Z","etag":null,"topics":["ghostty","git","macos","swift","terminal","tmux","workspace","worktree"],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vaayne.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-19T09:57:15.000Z","updated_at":"2026-04-03T13:55:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/vaayne/mori","commit_stats":null,"previous_names":["vaayne/mori"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/vaayne/mori","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaayne%2Fmori","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaayne%2Fmori/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaayne%2Fmori/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaayne%2Fmori/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vaayne","download_url":"https://codeload.github.com/vaayne/mori/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaayne%2Fmori/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31441057,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-05T15:22:31.103Z","status":"ssl_error","status_checked_at":"2026-04-05T15:22:00.205Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ghostty","git","macos","swift","terminal","tmux","workspace","worktree"],"created_at":"2026-04-03T09:04:59.758Z","updated_at":"2026-04-05T16:00:58.478Z","avatar_url":"https://github.com/vaayne.png","language":"Swift","readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/banner.svg\" alt=\"Mori\" width=\"600\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cb\u003eEnglish\u003c/b\u003e | \u003ca href=\"README.zh-Hans.md\"\u003e中文\u003c/a\u003e\n\u003c/p\u003e\n\nA native macOS workspace terminal organized around **Projects** and **Worktrees**, powered by **tmux** and **libghostty**.\n\nInstead 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.\n\n## Why Mori\n\n- **Project-first navigation** — switch between repos and branches, not anonymous tabs\n- **Local + remote projects** — add local folders or SSH-hosted repositories from one Add flow\n- **Persistent sessions** — close the app, reopen later, everything is still running in tmux\n- **Native macOS experience** — sidebar, command palette, notifications, keyboard shortcuts\n- **GPU-rendered terminal** — libghostty (Ghostty's rendering engine) with Metal acceleration\n- **Worktree-aware** — multiple branches of the same repo run side-by-side with independent sessions\n\n## How It Works\n\n```\nProject (git repo)\n  └─ Worktree (branch checkout)\n       └─ tmux Session\n            ├─ Window (tab)   →  Pane\n            ├─ Window         →  Pane | Pane\n            └─ Window         →  Pane\n```\n\nEach 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.\n\n## Architecture\n\n```\nApp (AppKit shell + SwiftUI sidebar views)\n  ├─ MoriCore         — Models + observable app state\n  ├─ MoriUI           — SwiftUI sidebar views\n  ├─ MoriTmux         — tmux CLI integration (actor)\n  ├─ MoriGit          — Git worktree/status discovery (actor)\n  ├─ MoriTerminal     — libghostty terminal surface\n  ├─ MoriPersistence  — SQLite via GRDB\n  └─ MoriIPC          — Unix socket IPC + `ws` CLI\n```\n\n## Requirements\n\n- macOS 14 (Sonoma) or later\n- tmux\n- [mise](https://mise.jdx.dev/) (task runner)\n- Zig 0.15.2 + Xcode (for building libghostty)\n\n## Install\n\n### Homebrew\n\n```bash\nbrew tap vaayne/tap\nbrew install --cask mori\n```\n\n### GitHub Releases\n\nDownload the latest release from [GitHub Releases](https://github.com/vaayne/mori/releases).\n\n- `.dmg`: Open the disk image and move `Mori.app` into `/Applications`\n- `.zip`: Extract the archive and move `Mori.app` into `/Applications`\n\nThe Homebrew tap installs `Mori.app`. Release bundles also embed the `mori` CLI for Homebrew-based installs, and the cask declares `tmux` as a dependency.\n\n## Build \u0026 Run\n\n```bash\nmise run build           # Debug build\nmise run build:release   # Release build\nmise run dev             # Build + run\nmise run test            # Run all tests\nmise run clean           # Clean build artifacts\n```\n\n`mise run build` and `mise run build:release` automatically bootstrap the libghostty XCFramework on first run. You can also build it manually:\n\n```bash\nmise run build:ghostty   # Requires Zig 0.15.2 + Xcode (downloads Metal Toolchain if missing)\n```\n\n## CLI\n\nThe `mori` command lets you interact with Mori from the terminal:\n\n```bash\nmori project list\nmori open /path/to/repo\nmori worktree create \u003cproject\u003e \u003cbranch\u003e\nmori focus \u003cproject\u003e \u003cworktree\u003e\nmori send \u003cproject\u003e \u003cworktree\u003e \u003cwindow\u003e \"command\"\nmori new-window \u003cproject\u003e \u003cworktree\u003e \u003cname\u003e\nmori pane list\nmori pane read \u003cproject\u003e \u003cworktree\u003e \u003cwindow\u003e [--lines N]\nmori pane message \u003cproject\u003e \u003cworktree\u003e \u003cwindow\u003e \"text\"\nmori pane id\n```\n\n## Terminal Configuration\n\nMori 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).\n\n## Keyboard Shortcuts\n\nSee [docs/worktrees.md](docs/worktrees.md) for worktree management and [docs/keymaps.md](docs/keymaps.md) for the full shortcut list. Highlights:\n\n| Shortcut                                                     | Action                |\n| ------------------------------------------------------------ | --------------------- |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003eT\u003c/kbd\u003e                                    | New tab (tmux window) |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003eW\u003c/kbd\u003e                                    | Close pane            |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003eD\u003c/kbd\u003e / \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eD\u003c/kbd\u003e | Split right / down    |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e1\u003c/kbd\u003e–\u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e9\u003c/kbd\u003e          | Go to tab N           |\n| \u003ckbd\u003e⌃\u003c/kbd\u003e+\u003ckbd\u003eTab\u003c/kbd\u003e / \u003ckbd\u003e⌃\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eTab\u003c/kbd\u003e | Cycle worktrees       |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eN\u003c/kbd\u003e                       | New worktree          |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003e⇧\u003c/kbd\u003e+\u003ckbd\u003eP\u003c/kbd\u003e                       | Command palette       |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003eB\u003c/kbd\u003e                                    | Toggle sidebar        |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003eG\u003c/kbd\u003e                                    | Lazygit               |\n| \u003ckbd\u003e⌘\u003c/kbd\u003e+\u003ckbd\u003eE\u003c/kbd\u003e                                    | Yazi                  |\n\n\n## License\n\n[MIT](LICENSE)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaayne%2Fmori","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaayne%2Fmori","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaayne%2Fmori/lists"}