{"id":48740998,"url":"https://github.com/thdxg/macterm","last_synced_at":"2026-06-06T09:01:00.165Z","repository":{"id":350799189,"uuid":"1208287465","full_name":"thdxg/macterm","owner":"thdxg","description":"A native macOS terminal with vertical tabs and persistent multiplexing","archived":false,"fork":false,"pushed_at":"2026-06-02T15:07:35.000Z","size":85069,"stargazers_count":238,"open_issues_count":4,"forks_count":11,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-02T15:18:58.597Z","etag":null,"topics":["ghostty","macos","multiplexer","terminal"],"latest_commit_sha":null,"homepage":"","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/thdxg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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":null,"dco":null,"cla":null}},"created_at":"2026-04-12T04:22:18.000Z","updated_at":"2026-06-02T13:57:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"3b745920-a04c-4c6a-acfe-1555426b7d6e","html_url":"https://github.com/thdxg/macterm","commit_stats":null,"previous_names":["thdxg/macterm"],"tags_count":65,"template":false,"template_full_name":null,"purl":"pkg:github/thdxg/macterm","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thdxg%2Fmacterm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thdxg%2Fmacterm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thdxg%2Fmacterm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thdxg%2Fmacterm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/thdxg","download_url":"https://codeload.github.com/thdxg/macterm/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/thdxg%2Fmacterm/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33975476,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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","macos","multiplexer","terminal"],"created_at":"2026-04-12T07:10:01.583Z","updated_at":"2026-06-06T09:01:00.093Z","avatar_url":"https://github.com/thdxg.png","language":"Swift","funding_links":[],"categories":["Terminal Apps \u0026 Clients"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n  \u003cimg src=\"./assets/icon.png\" width=\"128\" /\u003e\n  \u003cbr /\u003e\n  Macterm\n\u003c/h1\u003e\n\n\u003cp align=\"center\"\u003e\n  A native macOS terminal with vertical tabs and persistent multiplexing, built on libghostty\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/thdxg/macterm/releases/latest\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/thdxg/macterm?label=version\u0026color=blue\" alt=\"Latest version\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/thdxg/macterm/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/thdxg/macterm/total\" alt=\"Total downloads\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/thdxg/macterm/actions/workflows/checks.yml\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/thdxg/macterm/checks.yml?branch=main\u0026label=checks\" alt=\"CI status\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/thdxg/macterm/blob/main/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/thdxg/macterm?color=lightgrey\" alt=\"License\" /\u003e\n  \u003c/a\u003e\n  \u003cimg src=\"https://img.shields.io/badge/macOS-26%2B-black?logo=apple\" alt=\"macOS 26+\" /\u003e\n\u003c/p\u003e\n\n![screenshot](./assets/screenshot.png)\n\n## Features\n\n- **Vertical Project Sidebar**: Native macOS sidebar for organizing projects and tabs vertically.\n- **Persistent Multiplexing**: Projects, tabs, and panes are saved and restored automatically on relaunch.\n- **Ghostty Config Compatibility**: Macterm reads your existing `~/.config/ghostty/config`. Theme, font, palette, keybinds — all of it just works.\n- **Keyboard-first Navigation**: Customizable keybinds for navigating projects, tabs, and panes.\n- **Command Palette**: Versatile command palette to interact with multiplexing and manage projects\n- **Quick terminal**: Global terminal accessible from anywhere with a hotkey.\n\n## Install\n\n### Homebrew\n\n```bash\nbrew install --cask thdxg/tap/macterm\n```\n\nThe cask strips the Gatekeeper quarantine xattr on install, so the app launches without any extra prompts. Updates are delivered via Sparkle inside the app.\n\n### From Releases\n\nDownload the latest `.dmg` from [Releases](https://github.com/thdxg/macterm/releases), open it, and drag Macterm to Applications.\n\nSince the app isn't signed with an Apple Developer certificate, macOS will block it on first launch. To allow the app to launch, run this command in another terminal (you only need to do this once):\n\n```bash\nxattr -cr /Applications/Macterm.app\n```\n\n## Demos\n\n### Keybinds\n\nMacterm is very keyboard-oriented, so you can perform the majority of actions without lifting your hand.\n\nhttps://github.com/user-attachments/assets/42b2dce8-1d6d-41d6-a4c8-2e0c1339810b\n\n### Window Opacity \u0026 Blur\n\nMacterm's window appearance is highly customizable and hot-reloaded. Drop the\nopacity below 100% and choose between a classic Gaussian **Background Blur** or\nthe macOS 26 **Liquid Glass** material — in two styles, frostier **Regular** or\nmore transparent **Clear** — all in **Settings → General → Window**.\n\nhttps://github.com/user-attachments/assets/1486ed55-e653-43ce-98aa-232a61d234a7\n\n## Configuration\n\nMacterm reads your `~/.config/ghostty/config` on launch — themes, fonts, palettes, keybinds, and everything else Ghostty supports works the same here. See the [Ghostty option reference](https://ghostty.org/docs/config/reference) for the full list of available settings. If your config is elsewhere, set the path in **Settings → General → Ghostty Config**.\n\nMacterm ships a thin defaults layer on top of Ghostty's own defaults. These are the values that differ:\n\n| Option                                                                                 | Macterm default | Ghostty default |\n| -------------------------------------------------------------------------------------- | --------------- | --------------- |\n| [`theme`](https://ghostty.org/docs/config/reference#theme)                             | `Rose Pine`     | _(none)_        |\n| [`font-size`](https://ghostty.org/docs/config/reference#font-size)                     | `16`            | `12`            |\n| [`window-padding-x`](https://ghostty.org/docs/config/reference#window-padding-x)       | `16`            | `2`             |\n| [`window-padding-y`](https://ghostty.org/docs/config/reference#window-padding-y)       | `16`            | `2`             |\n| [`macos-option-as-alt`](https://ghostty.org/docs/config/reference#macos-option-as-alt) | `true`          | `false`         |\n\nAdd any of these to your Ghostty config to override them. Macterm-specific settings (window opacity, blur style, quick terminal size, hotkeys) live in **Macterm → Settings**.\n\nA few settings are overridden because Macterm handles that chrome itself: `background-opacity` and `background-blur` are forced to `0` (use **Settings → General → Window** instead), and titlebar, window decoration, split-divider, and quick-terminal settings are ignored.\n\nGhostty keybinds work normally unless they conflict with a Macterm shortcut — on conflict, Macterm wins. Every Macterm shortcut is rebindable in **Settings → Keymaps**. Note that Ghostty app-level actions (`new_split`, `new_tab`, etc.) do nothing in Macterm; use Macterm's own keybinds for those.\n\nShell integration works standalone — no Ghostty.app needed. The one exception is `ssh-env`, `ssh-terminfo`, and `path` features, which require the `ghostty` CLI; install Ghostty.app to enable them.\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for setup, build, and PR guidelines.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthdxg%2Fmacterm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthdxg%2Fmacterm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthdxg%2Fmacterm/lists"}