Zsh Tool

arktechnwa/zsh-tool

Gives Claude native zsh execution with PTY support so it can handle interactive prompts and password entry. Built to fix the quotation mismatches and shell confusion that happen when you run zsh locally but Claude uses its Bash tool. Returns control after a configurable timeout with partial output instead of hanging forever, then lets you poll for incremental results or send additional input. Ships with NEVERHANG circuit breaker that tracks timeout patterns and blocks repeatedly hanging commands, plus A.L.A.N. short-term memory that detects retry loops and surfaces man page options when commands fail repeatedly. Exposes zsh, zsh_poll, zsh_send, zsh_kill, and zsh_tasks for full shell session management.

GitHub stars

4

tools

10

transport

STDIO

env var

1

last updated

Jan 15, 2026

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language