Shell
Safe shell command execution via a whitelist allowlist.
zero-config4 tools
Works immediately. Allowed commands: ls, cat, git, npm, yarn, pnpm, node, python, echo, pwd, which, env, ps, df, du, find, grep, curl, ping.
Run shell commands from your AI. The shell plugin uses a whitelist-based allowlist — only approved commands can be executed. No eval() or exec() with arbitrary strings.
Setup
terminal
No setup required. Customize the allowed commands list in your config:Tools
| Tool | Description | Inputs | Approval |
|---|---|---|---|
shell_exec | Execute a whitelisted shell command | command, args?, cwd? | — |
shell_background | Run a command in the background | command, args? | required |
shell_kill | Kill a background process by PID | pid | required |
shell_list | List allowed commands | — | — |
Tools marked required will prompt the user for approval before execution. These are typically write, delete, or send operations.
Example Prompts
“Run npm test in the current directory”
shell_exec“Start the dev server in the background”
shell_background