Zsh Tool
by arktechnwacommunityv0.2.1
4
zsh-tool is a Zsh execution tool designed for Claude Code that provides yield-based oversight, PTY mode, and intelligent command management to prevent issues like hanging commands and shell confusion.
From the registry: Zsh for Claude Code. PTY mode lets Claude type passwords. NEVERHANG + A.L.A.N.
Install & configure
Prerequisites
- requiredRust toolchainRust (cargo) is required to build the MCP server binary from source
https://www.rust-lang.org/$ curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh - requiredzshzsh shell must be installed (typically pre-installed on macOS)
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `zsh-tool` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Rust toolchain** — Rust (cargo) is required to build the MCP server binary from source Run: `curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh` (https://www.rust-lang.org/)
- **zsh** — zsh shell must be installed (typically pre-installed on macOS)
Canonical MCP server config (stdio transport):
- command: `/path/to/zsh-tool/scripts/run-mcp.sh`
- args: []
- optional environment variables:
- `NEVERHANG_TIMEOUT_DEFAULT`: Default timeout in seconds for command execution (example: `120`)
- `NEVERHANG_TIMEOUT_MAX`: Maximum allowed timeout in seconds (example: `600`)
- `ALAN_DB_PATH`: Path to A.L.A.N. SQLite database (example: `/path/to/zsh-tool/data/alan.db`)
- `ALAN_MANOPT_ENABLED`: Enable man-page option hints on repeated failures (default: 1) (example: `1`)
Note: Zsh execution tool for Claude Code. Install via ArkTechNWA marketplace: `/plugin install arktechnwa/zsh-tool`. The run-mcp.sh wrapper auto-builds the Rust binary on first run. Provides yield-based execution, PTY mode, NEVERHANG circuit breaker, and A.L.A.N. 2.0 learning engine.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Zsh execution tool for Claude Code. Install via ArkTechNWA marketplace: `/plugin install arktechnwa/zsh-tool`. The run-mcp.sh wrapper auto-builds the Rust binary on first run. Provides yield-based execution, PTY mode, NEVERHANG circuit breaker, and A.L.A.N. 2.0 learning engine.
Tools (10)
zsh
Execute command with yield-based oversight
zsh_poll
Get new output (delta) from running task with line numbers
zsh_send
Send input to task's stdin
zsh_kill
Kill a running task
zsh_tasks
List all active tasks
zsh_health
Overall health status
zsh_alan_stats
A.L.A.N. database statistics
zsh_alan_query
Query pattern insights for a command
zsh_neverhang_status
Circuit breaker state
zsh_neverhang_reset
Reset circuit to CLOSED
Environment variables
NEVERHANG_TIMEOUT_DEFAULTrequiredDefault timeout (120s)NEVERHANG_TIMEOUT_MAXrequiredMaximum timeout (600s)ALAN_MANOPT_ENABLEDrequiredEnable man-page option hints on failure (default: 1)ALAN_MANOPT_TIMEOUTrequiredMax seconds to wait for manopt parsing (default: 2.0)ALAN_MANOPT_FAIL_TRIGGERrequiredFail count to trigger async lookup (default: 2)ALAN_MANOPT_FAIL_PRESENTrequiredFail count to present cached options (default: 3)Prerequisites
- • Python 3.14
Packages
zsh-tool-mcp
pypiv0.2.1transport: stdio
Details
- Language
- Rust
- License
- MIT
- Released
- Jan 15, 2026
- Last commit
- Mar 27, 2026
- Registry name
- io.github.ArkTechNWA/zsh-tool