elizaos--eliza/plugins/plugin-shell/env.example

# Shell Plugin Configuration
#
# This plugin provides shell command execution with PTY support,
# background execution, and session management.

# The directory that the shell commands are restricted to
# The agent cannot execute commands outside this directory
# Defaults to the current working directory if not set
SHELL_ALLOWED_DIRECTORY=/path/to/safe/directory

# Maximum command execution timeout in milliseconds
# Defaults to 30000 (30 seconds)
SHELL_TIMEOUT=30000

# Comma-separated list of additional forbidden commands
# Defaults to a safe list including rm -rf /, shutdown, reboot, etc.
SHELL_FORBIDDEN_COMMANDS=rm,mv,cp,chmod,chown,shutdown,reboot,kill,pkill

# Maximum output characters to capture from commands
# Defaults to 200000 (200KB)
SHELL_MAX_OUTPUT_CHARS=200000

# Maximum pending output characters per stream
# Defaults to 200000 (200KB)
SHELL_PENDING_MAX_OUTPUT_CHARS=200000

# Default milliseconds to wait before backgrounding long-running commands
# Commands that don't complete within this time are moved to background
# Defaults to 10000 (10 seconds)
SHELL_BACKGROUND_MS=10000

# Whether to allow background command execution
# Set to false to run all commands synchronously
# Defaults to true
SHELL_ALLOW_BACKGROUND=true

# Time-to-live for finished session records in milliseconds
# Session records are cleaned up after this time
# Defaults to 1800000 (30 minutes)
SHELL_JOB_TTL_MS=1800000