Tool: Shell

[joshuadarron]

Implement a Shell tool node that executes shell commands in the host environment.

Tool Description (copy for node UI)

Executes shell commands in the host environment. Use to run scripts, manage processes, install packages, and interact with the operating system via the command line.

Common use cases:

• Build scripts: npm run build, python setup.py install, make
• Package management: npm install, pip install, apt-get install
• Process management: starting/stopping services, checking process status
• File operations: cp, mv, rm, mkdir, find, grep
• Environment inspection: env, echo $PATH, which <binary>
• Git operations (when git is available on the host): git status, git add, git commit -m "message", git push, git pull, git clone <url>, git log --oneline, git diff, git checkout -b <branch>, git merge <branch>

Note: For portable git operations that do not depend on the host environment having git installed, use the Git node instead.

Acceptance Criteria

• Accepts a command string and executes it in the host shell
• Returns stdout and stderr
• Supports working directory configuration
• Supports environment variable injection per execution

[github-actions]