Skip to main content

shell

Execute shell commands and scripts with full output capture, background task management, and stdin interaction.

PropertyValue
Module IDshell
Version1.0.0
Typeuser
DependenciesNone (uses subprocess)

Design Philosophy​

  • Structured output — every command returns stdout, stderr, and exit code as separate fields. No parsing needed.
  • Background tasks — long-running commands run in the background with status polling and output streaming.
  • Process management — kill, wait, send input to running tasks.
  • Security-classified — all execution actions are high risk. Environment listing is medium. Status checks are low.

Configuration​

modules:
  shell: {}

Actions (12)​

run​

Execute a shell command. Returns stdout, stderr, exit code. Risk: high

script​

Execute a script file. Risk: high

bash​

Execute a multi-line bash script block. Risk: high

which​

Find the full path of an executable in PATH. Risk: low

env​

List environment variables with optional prefix filter. Sensitive values are masked. Risk: medium

background_run​

Launch a command in the background. Returns a task ID for monitoring. Risk: high

task_status​

Check if a background task is running or finished. Risk: low

task_output​

Get buffered stdout/stderr from a background task. Risk: low

task_kill​

Kill a running background task. Risk: high

task_list​

List all background tasks with their status. Risk: low

task_wait​

Wait for a background task to finish. Risk: low

task_send_input​

Send text to a running task's stdin. Risk: medium