Zsh and the Server Terminal: a practical guide

The naming: Zsh, zshell, and ZShell

Zsh (the Z shell) is the shell you type into — the interpreter behind Oh My Zsh, powerline prompts, autosuggestions, and a plugin ecosystem two decades in the making. When you see "zshell" in the wild, nine times out of ten it's a misspelling of this same tool.

ZShell is a different thing: a desktop server terminal for Windows, macOS, and Linux. It's an SSH terminal, an SFTP client, and an MCP server in one. It doesn't reimplement Zsh; it connects to it.

• Zsh = the shell running on your machine and on the servers you manage
• ZShell = the desktop app that opens remote sessions into those shells

Your .zshrc should travel with you

The best argument for keeping Zsh at the center of a server workflow is the work you've already put into it: aliases, functions, completions, prompt themes, and the muscle memory that goes with them. A terminal that resets your environment on every host throws all of that away.

ZShell opens a real remote shell, so the .zshrc, plugins, and prompt you tuned on one host run unchanged on the next. There's no compatibility shim and no reimplementation — just your shell, reachable from a desktop client.

• aliases and functions keep working
• completions and keybindings stay intact
• your prompt theme renders exactly as configured

What a plain terminal forgets

A bare SSH client forgets everything when you close the tab. ZShell keeps per-host command history, so a command you ran on staging three weeks ago is one search away — no matter which machine you're sitting at now.

A global command palette searches across saved connections, quick commands, and file paths. And because ZShell tracks the remote shell's working directory over OSC7, the SFTP panel follows along automatically instead of making you navigate twice.

Make setup repeatable, then hand it to an agent

Anything you run more than once belongs in a quick command or the built-in command library: stack install scripts, hardening steps, monitoring one-liners. Store them once, then fire them from the searchable palette.

When you're ready to delegate, ZShell exposes those same hosts as an MCP server. Claude, Cursor, Codex, and opencode can list connections, read files, and run commands — with run_command executing through the remote user's own shell, your Zsh included.

• run_command runs through the remote user's shell, inheriting the same .zshrc and PATH
• dangerous commands are blocked; every other sensitive action waits on your approval

Start in two minutes

Download ZShell for your platform, add a host, and connect — your preferred shell is right where you left it.

• Free: SSH terminal, SFTP, monitor, command library
• Pro: device pairing, folder sync, AI agents (MCP), cloud sync