Installation

Zshell is not notarized by Apple. The home page shows the minimum macOS version the current release needs, next to the download.

Download

Download the .dmg from the home page. The current 0.1.3 release provides Universal, Apple Silicon, and Intel packages, with Gitee available as a mirror. Open the disk image and drag Zshell into Applications.

On first launch, macOS may block the app. After trying to open it, go to System Settings → Privacy & Security → Open Anyway, then confirm opening Zshell. This also applies to Homebrew installations.

Homebrew

brew install wzz6423/tap/zshell

The cask lives in wzz6423/homebrew-tap and installs the ZIP for your Mac's processor. Zshell uses Sparkle for updates after installation. To explicitly update through Homebrew, or catch up when the installed version is behind:

brew upgrade --cask --greedy-auto-updates zshell

Updates

Both direct downloads and Homebrew installations use Sparkle. Zshell checks the Gitee update source first and retries GitHub once if the feed or download fails. It verifies the signed feed and update package before installation and keeps the installed architecture; Intel apps running under Rosetta migrate to Apple Silicon.

Open Settings → Updates (Cmd+,) to control automatic checks, or choose Check for Updates… to check now. Downloaded updates install when you quit or restart Zshell. Use the Homebrew command above for an explicit update or when the installed version is behind.

Open a folder from Finder

Zshell registers a macOS service called New Zshell Project Here. Select one or more folders in Finder, right-click, and pick it from the Services submenu — each folder opens as a project with its terminal already started there.

If it's missing from the menu, turn it on under System Settings → Keyboard → Keyboard Shortcuts → Services → Files and Folders. macOS only lists a new service after the app has been launched once.

Uninstalling

If Settings → Automation → AI is enabled, turn it off before deleting the app so Zshell can remove the agent support it installed.

Delete zshell.app from Applications, then remove its settings if you want a clean slate:

rm -rf ~/.config/zshell

Window layout, sidebar widths, and the session snapshot live in macOS's own preference store:

defaults delete sh.zshell