zsh-tool

Name: zsh-tool
Author: ArkTechNWA

ArkTechNWA

Zsh execution MCP tool for Claude Code with yield-based oversight, NEVERHANG circuit breaker, and A.L.A.N. learning

Setup

Choose your client, copy the config, then fill in any required environment variables.

claude mcp add zsh-tool -- uvx zsh-tool-mcp

~/.codex/config.toml

[mcp_servers.zsh-tool]
command = "uvx"
args = ["zsh-tool-mcp"]

# codex mcp add zsh-tool -- uvx zsh-tool-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "zsh-tool": {
      "command": "uvx",
      "args": [
        "zsh-tool-mcp"
      ]
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "zsh-tool": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zsh-tool-mcp"
      ]
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "zsh-tool": {
      "command": "uvx",
      "args": [
        "zsh-tool-mcp"
      ]
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "zsh-tool": {
      "command": "uvx",
      "args": [
        "zsh-tool-mcp"
      ]
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "zsh-tool": {
      "command": "uvx",
      "args": [
        "zsh-tool-mcp"
      ]
    }
  }
}