Documentation
Install Zshell, manage projects and terminals, and use Git, browser panes, and coding agents.
Get started
Installation
Downloads, Homebrew, system requirements, and updates.
Quick start
Add a project, create sessions, split panes, and review code.
Keyboard shortcuts
Common actions, Quick Terminal, and custom shortcuts.
Configuration
Appearance, terminal behavior, configuration files, and migration.
Workspace structure
| Object | Purpose |
|---|---|
| Project | A local directory or SSH connection, organized in sidebar groups |
| Session | A project tab that you can rename, color, pin, and group |
| Pane | A terminal, browser, editor, or diff within a tab; split panes to work side by side |
Feature reference
| Feature | Topics |
|---|---|
| Projects and sessions | Local / SSH projects, tabs, terminal environments, and restoration |
| Panes | Splitting, focus, zoom, and layouts |
| Terminal | Ghostty / Alacritty, search, notifications, prompt queues, and Quick Terminal |
| Quick Launch | Saved commands, SSH connections, and groups |
| Browser panes | Websites and local services beside their terminal |
| Git panel | Diffs, staging, commits, branches, stashes, and worktrees |
| Files and editor | File search, editing, Markdown previews, and external editors |
| Processes and ports | Session processes, listening ports, and resource usage |
| Agent coordination | Pane coordination, agent status, and account usage |
License and privacy
Zshell is free, with public source under the PolyForm Noncommercial License 1.0.0, and requires no account or subscription. The app has no telemetry or analytics. Updates, tool version checks, and configured agent usage services may access the network; browser panes and command-line tools make their own requests. See the FAQ.