What it does
zsh-tool is an MCP server that gives Claude Code a zsh execution tool with Bash-tool parity. Commands return partial output after a set number of seconds instead of hanging, and zsh_poll returns only new output with line numbers. zsh_send provides input, and zsh_kill and zsh_tasks manage running tasks. PTY mode runs interactive programs and lets Claude Code type passwords. The NEVERHANG circuit breaker opens after three timeouts for the same command within an hour and recovers automatically after five minutes. A.L.A.N. 2.0 records retries, success and failure streaks, killed commands and SSH results, and surfaces command options from man pages after repeated failures.
It suits users who work in zsh and see quoting mismatches or repeated debug loops with Claude Code's Bash tool. It also fits long-running commands such as package installs, programs that prompt for input, and commands that time out repeatedly.
Running it requires zsh and Claude Code. The man-page option lookup reads local man pages and caches results in SQLite, and it is on by default but can be disabled with an environment variable. Polling suggestions are advisory, and the agent decides what to do.
Limitations and requirements
The publisher describes the project as beta. Command option lookup depends on man pages installed locally.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.ArkTechNWA/zsh-tool
Zsh for Claude Code. PTY mode lets Claude type passwords. NEVERHANG + A.L.A.N.
v0.2.1As shown on registry.modelcontextprotocol.io when we last read it