Zshell

English | 简体中文

Zshell is a native macOS terminal workspace for developers who keep shells, projects, source code, and AI coding agents moving at the same time. It keeps the terminal primary while making files, diffs, repository state, and project controls quick to inspect.

Zshell requires macOS 15.6 or later.

Highlights

• Native AppKit interface for projects, tabs, and split panes
• libghostty by default, with an optional Alacritty backend
• Integrated browser tabs and panes
• File tree, Git status, and editable diffs
• Command palette, project-wide file search, and local path links
• AI agents can delegate background work and coordinate across Zshell panes, with provider-reported status and human-controlled approvals

Open Settings with Cmd+,. The sidebar groups settings by category; search for an option name, description, or configuration key, then select a result to jump to its setting. General also offers System, Light, and Dark appearance previews. Cmd+F focuses settings search, and Cmd+[ / Cmd+] moves through previously visited categories.

Get started

Download the latest release from the Zshell website, or install it with Homebrew:

brew install wzz6423/tap/zshell

Run from source

A full Xcode installation and the development dependencies described in CONTRIBUTING.md are required.

git clone https://github.com/wzz6423/zshell.git
cd zshell
cp mac/Config/Local.example.xcconfig mac/Config/Local.xcconfig
# Set DEVELOPMENT_TEAM in mac/Config/Local.xcconfig for your Apple Development certificate.
make run

make run builds and launches the separately identified Debug app. See the local signing instructions before sharing a build or diagnosing a signing failure.

Repository layout

• mac/ — macOS app, Xcode project, dependencies, and build/release scripts.
• web/ — website and user documentation.
• skills/ — app development and release workflows for coding agents.

The root Makefile provides run, update, stop, build-package, and clean. Install Bun dependencies separately in mac/ and web/; each has its own lockfile.

Documentation

Document	Purpose
User documentation	Learn the app's workflows and settings.
Contributing guide	Set up the app, configure local signing, build, verify, and open a pull request.
Release guide	Maintainer-only stable signing, Sparkle, and GitHub/Gitee release process.
Security policy	Supported versions and private vulnerability reporting.
Localization guide	Translate and test app text.
Website guide	Build and maintain the static site and its user documentation.

Contributing

Issues and pull requests are welcome. Read the contributing guide first. Report security vulnerabilities privately through GitHub Security Advisories, not a public issue.

gitee.com/wzz6423/zshell mirrors every branch of this repository, for cloning from networks where GitHub is slow. It only ever receives what has already landed here, so issues and pull requests belong on GitHub.

Participation in this project is governed by the Code of Conduct.

License

PolyForm Noncommercial License 1.0.0 — free for personal, educational, research, and other noncommercial use.