Skip to content
Back to search

zentty

A native macOS terminal for agent-driven development, built on Ghostty.

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dedene/zentty with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dedene/zentty'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dedene--zentty/badge.svg)](/listings/dedene--zentty)

HTML

<a href="/listings/dedene--zentty"><img src="/api/listings/dedene--zentty/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.

With [Homebrew](https://brew.sh):

brew install --cask zentty

Or download the latest `.dmg` from the [releases page](https://github.com/dedene/zentty/releases/latest), open it, and drag Zentty to your Applications folder.

Zentty updates itself in place via [Sparkle](https://sparkle-project.org) once installed. No need to check back here for new versions.

Builds are signed and notarized by Zenjoy BV. Requires macOS 14 (Sonoma) or later.

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 · 165 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <!-- LOGO -->
  2. <h1>
  3. <p align="center">
  4. <img src="assets/icon.png" alt="Zentty" width="128">
  5. <br>Zentty
  6. </h1>
  7. <p align="center">
  8. A native macOS terminal for agent-driven development, built on Ghostty.
  9. <br />
  10. Zentty gets out of the way. Minimal friction, maximum focus.
  11. <br />
  12. <a href="https://github.com/dedene/zentty/releases/latest/download/Zentty.dmg">Download</a>
  13. ·
  14. <a href="#install">Install</a>
  15. ·
  16. <a href="#status">Status</a>
  17. ·
  18. <a href="#build">Build</a>
  19. ·
  20. <a href="CONTRIBUTING.md">Contributing</a>
  21. </p>
  22. </p>
  23. <p align="center">
  24. <img src="assets/screenshot.png" alt="Zentty screenshot" width="880">
  25. </p>
  26. ## Features
  27. **Layout**
  28. - **Worklanes, not tabs.** A horizontally scrolling strip of columns, each a vertical stack of panes, borrowed from niri and Hyprland. Drag, resize, and rearrange without losing your place.
  29. - **Keyboard-first.** Every action is a command, every command is bindable, and a fuzzy command palette catches whatever you forgot. Ghostty-compatible shortcuts out of the box.
  30. - **Visual pane switcher.** Hold Ctrl+Tab to zoom out and pick a pane. ⌘⇧T reopens the pane you just closed.
  31. - **Restore everything.** Worklanes, sidebar, pane output, and agent sessions come back on relaunch. Closed mid-task? Zentty resumes the agent, or reruns your last shell command.
  32. **Agents**
  33. - **Agent-aware sidebar.** Agents report status into the sidebar: working, waiting, asking for approval, compacting. You see who needs you without switching panes.
  34. - **Subagents and teams.** A badge shows how many subagents are running and which models they use. Parents stay visible while background work continues. Teammates from Claude Code agent teams and other tmux-based agent tools can open as panes of their own ([Agent Teams](docs/agent-teams.md), experimental).
  35. - **Menu bar status.** Agent state lives in the macOS menu bar, so you know who needs you even when Zentty is hidden.
  36. - **1Password prompts point home.** When `op` or ssh-agent asks for approval, Zentty tells you which pane triggered it and can jump there.
  37. - **Stays awake.** Zentty caffeinates the Mac while an agent is running.
  38. - **Fork a conversation.** Branch an agent's conversation into a new pane with its own fork command while the original keeps going.
  39. Supported agents: Amp, Antigravity, Claude Code, Codex, Copilot CLI, Cursor, Devin, Droid, Gemini CLI, Grok Build, Hermes Agent, Kimi, Mistral Vibe, Muse Code, Oh My Pi, OpenCode, Pi, and Small Harness. Any other tool can join via the [Agent Status Protocol](docs/agent-status-protocol.md).
  40. **Projects**
  41. - **Dev servers and PRs in the sidebar.** Running localhost servers show as clickable ports. Panes on a branch with a PR or a GitLab MR show its checks and review state (needs `gh` or `glab`).
  42. - **Task runners.** Detects package.json scripts, Makefiles, justfiles, Taskfiles, and mise tasks, and runs them from the palette.
  43. - **Global search.** Search inside a pane or across every worklane from one shortcut.
  44. **Remote and terminal**
  45. - **Paste files into ssh sessions.** Drop an image, PDF, or archive on a remote pane and Zentty uploads it over the existing ssh connection and pastes the remote path.
  46. - **Status from any program.** A build, test run, or remote script can show progress, an error, or a pause in the sidebar by printing the standard OSC 9;4 progress sequence. See [Program Status](docs/program-status.md).
  47. - **Clean copy.** Copy agent output without prompts, box drawing, and tracking params. Copy as Markdown keeps the structure.
  48. - **Native Ghostty themes.** Built-in picker with live preview, opacity, and blur. Fine without Ghostty installed too.
  49. - **Built on libghostty.** GPU rendering in a native Swift and AppKit shell. No Electron, no web views.
  50. - **Scriptable.** Drive worklanes and panes, type into them, read their screens, and stream agent and pane events from the embedded `zentty` CLI.
  51. See [Zentty CLI](docs/cli.md) for command-line usage.
  52. See [Configuration and Syncing](docs/configuration.md) for where settings live and how to share them between Macs.
  53. ## Agent Skill
  54. Agents can install the Zentty CLI skill to discover pane-aware commands while running inside Zentty:
  55. ```bash
  56. npx skills add dedene/zentty
  57. ```
  58. ## Install
  59. With [Homebrew](https://brew.sh):
  60. ```bash
  61. brew install --cask zentty
  62. ```
  63. Or download the latest `.dmg` from the [releases page](https://github.com/dedene/zentty/releases/latest), open it, and drag Zentty to your Applications folder.
  64. Zentty updates itself in place via [Sparkle](https://sparkle-project.org) once installed. No need to check back here for new versions.
  65. Builds are signed and notarized by Zenjoy BV. Requires macOS 14 (Sonoma) or later.
  66. ## Status
  67. Zentty is in active development. Expect rapid iteration, rough edges, and occasional breaking changes while the project is opened up.
  68. ## Requirements
  69. - macOS 14 (Sonoma) or later
  70. - Xcode
  71. - `zig` on `PATH`
  72. - `gettext` on `PATH`
  73. ## Build
  74. Zentty requires a local `GhosttyKit.xcframework` before the app can build normally.
  75. Build the framework:
  76. ```bash
  77. ./scripts/build_ghosttykit.sh
  78. ```
  79. Then build the app:
  80. ```bash
  81. xcodebuild -project Zentty.xcodeproj -scheme Zentty -destination 'platform=macOS' build
  82. ```
  83. If you need to regenerate the Xcode project from [`project.yml`](project.yml):
  84. ```bash
  85. bundle exec fastlane mac generate_project
  86. ```
  87. ### Dependencies
  88. Swift package versions are pinned in `Zentty.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved`, which is committed. The version ranges in `project.yml` say what is allowed; the resolved file says what actually ships. Release builds run with automatic package resolution disabled, so they fail rather than drift when the pins no longer satisfy the ranges.
  89. To bump a dependency, update the range in `project.yml` if needed, then resolve and commit the new pins:
  90. ```bash
  91. xcodebuild -resolvePackageDependencies -project Zentty.xcodeproj -scheme Zentty
  92. git add Zentty.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved
  93. ```
  94. The release lane builds Sparkle's `generate_appcast` from the pinned Sparkle revision. It reuses a checkout that already sits at that revision (the release build's `build/SourcePackages`, or Xcode's DerivedData) and otherwise clones it into `build/sparkle-tools`. `bundle exec fastlane mac build_generate_appcast` builds the tool on its own.
  95. More detail about the Ghostty bootstrap flow lives in [`docs/ghosttykit-setup.md`](docs/ghosttykit-setup.md).
  96. ## Test
  97. Run the full test suite:
  98. ```bash
  99. ZENTTY_TEST_DISPLAY_PROVIDER=betterdisplay scripts/test-on-virtual-display
  100. ```
  101. ## Agent Hooks
  102. Zentty bundles helper commands and environment variables for agent-aware workflows inside terminal panes.
  103. Hook configuration details are documented in [`docs/agent-hooks.md`](docs/agent-hooks.md).
  104. For Kimi specifically: do first-time auth with `kimi login` before using wrapped `kimi` inside Zentty. Zentty passthroughs Kimi's management commands directly to the real Kimi binary so login/logout keep using the default Kimi config. If you want a specific model, prefer `kimi --model <model-id>` or set `default_model` in `~/.kimi/config.toml` (or `~/.kimi-code/config.toml` for modern Kimi Code CLI).
  105. ## Contributing
  106. Contributions are welcome. Start with [`CONTRIBUTING.md`](CONTRIBUTING.md).
  107. Before a non-trivial contribution can be merged, contributors must agree to [`CLA.md`](CLA.md).
  108. ## License
  109. Zentty is available under the GNU General Public License v3.0 only (`GPL-3.0-only`). See [`LICENSE`](LICENSE).
  110. If your organization cannot or does not want to comply with GPLv3, alternative commercial licensing may be available from Zenjoy BV. Contact `hallo@zenjoy.be`.
  111. ## Trademarks
  112. The GPL license covers the code. It does not grant rights to use the Zentty name, logos, icons, or other branding for your own distribution.
  113. See [`TRADEMARKS.md`](TRADEMARKS.md) for branding rules.

Ratings and comments

Sign in to rate this skill.

Sign in

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