Zsh for Claude Code. PTY mode lets Claude type passwords. NEVERHANG + A.L.A.N.
If you already use Zsh, the zsh mcp server is the piece that lets your assistant work with it directly. Zsh for Claude Code. PTY mode lets Claude type passwords. NEVERHANG + A.L.A.N.
Zsh execution tool for Claude Code with full Bash parity, yield-based oversight, PTY mode, NEVERHANG circuit breaker, and A.L.A.N. short-term learning.
The toolset is worth reading before you wire it up, because it tells you what the integration is really for:
zsh — Execute command with yield-based oversightzsh_poll — Get new output (delta) from running task with line numberszsh_send — Send input to task's stdinzsh_kill — Kill a running taskzsh_tasks — List all active taskszsh_health — Overall health statuszsh_alan_stats — A.L.A.N. database statisticszsh_alan_query — Query pattern insights for a commandzsh_neverhang_status — Circuit breaker statezsh_neverhang_reset — Reset circuit to CLOSEDInstallation goes through your MCP client rather than a global install: point it at required on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Configuration is passed through the environment: NEVERHANG_TIMEOUT_DEFAULT, NEVERHANG_TIMEOUT_MAX, ALAN_DB_PATH. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
Among the planning and project tracking options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Zsh's toolset — zsh, zsh_poll, zsh_send and 7 more — is a fair guide to whether it matches your workflow. It is maintained by ArkTechNWA; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| 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 |
{
"mcpServers": {
"zsh-tool": {
"type": "stdio",
"command": "/path/to/zsh-tool/scripts/run-mcp.sh",
"env": {
"NEVERHANG_TIMEOUT_DEFAULT": "120",
"NEVERHANG_TIMEOUT_MAX": "600"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| NEVERHANG_TIMEOUT_DEFAULT | Configuration value read at startup. | Optional |
| NEVERHANG_TIMEOUT_MAX | Configuration value read at startup. | Optional |
| ALAN_DB_PATH | Filesystem location the server is allowed to use. | Optional |
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Your assistant inside the workspace — read channels, search history, post messages and tame the noise.
Metabase ships its own MCP endpoint — search your BI content, build and run queries, and save questions and dashboards without leaving the chat.
Stop letting your assistant hallucinate n8n node parameters — this server hands it the real schemas, templates and validation.