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
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
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.
