Claude Code mod

shell-shim

Fixes the zsh pitfalls Claude's bash-style commands trip over — = words, unmatched globs, word splitting, aliases that hide programs, a missing timeout — before the command runs

2 starsWorkflow modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/MichaelP17/claude-mods.git
claude --plugin-dir ./claude-mods/shell-shim

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L2Writes or runs: runs processes, reads files, reads env vars, draws
Sees
Bash calls
Hooks
session.starttool.call

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Folder
shell-shim
Author
Michael Prömpler
License
MIT
Last updated
16 October 2026

FAQ

What is shell-shim?

Fixes the zsh pitfalls Claude's bash-style commands trip over — = words, unmatched globs, word splitting, aliases that hide programs, a missing timeout — before the command runs It is a mod for Claude Code, from MichaelP17/claude-mods on GitHub.

What can the shell-shim mod access?

Its widest reach is "writes or runs" (runs processes, reads files, reads env vars, draws). It sees Bash calls. Like any mod, it runs with your permissions.

How do I install shell-shim?

Clone MichaelP17/claude-mods and start Claude Code with --plugin-dir pointing at the mod's folder (shell-shim).

Is shell-shim popular?

MichaelP17/claude-mods has 2 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 16 October 2026.

More workflow mods

Browse the most popular Claude Code mods, all workflow mods, or the skills and MCP server directories.