Shell and System

Shell execution, environment variables, scheduling, and desktop automation.

← Prebuilt Tools overview

Tool	Extra	Description
environment	base	Read, set, and unset environment variables.
shell	base	Execute shell commands with stdout/stderr capture.
cron	base	Add, list, and remove cron jobs.
use_computer	use-computer	Desktop automation — mouse, keyboard, and OCR.

---

environment

Read, set, and unset environment variables.

from elsai_tools.environment import environment

Parameter	Type	Required	Description
action	str	Yes	list, get, set, delete, or validate
name	str	No	Variable name
value	str	No	Value to set
prefix	str	No	Filter by prefix (list)
masked	bool	No	Mask sensitive values

shell

Execute shell commands with stdout/stderr capture.

from elsai_tools.shell import shell

Parameter	Type	Required	Description
command	Union[str, List[Union[str, Dict[str, Any]]]]	Yes	Command string, list of commands, or command objects
parallel	bool	No	Run commands in parallel
ignore_errors	bool	No	Continue on failure
timeout	int	No	Timeout in seconds
work_dir	str	No	Working directory
non_interactive	bool	No	Skip confirmation prompt

cron

Add, list, and remove cron jobs.

from elsai_tools.cron import cron

Parameter	Type	Required	Description
action	str	Yes	add, list, or remove
schedule	str	No	Cron expression
command	str	No	Command to run
job_id	int	No	Job ID (remove)
description	str	No	Human-readable description

use_computer

Desktop automation — mouse, keyboard, and OCR.

from elsai_tools.use_computer import use_computer

Extra: use-computer

Parameter	Type	Required	Description
action	str	Yes	Action type (click, type, screenshot, etc.)
x	int	No	Screen X coordinate
y	int	No	Screen Y coordinate
text	str	No	Text to type
key	str	No	Key to press
region	List[int]	No	Screen region [x, y, w, h]
app_name	str	No	Target application
click_type	str	No	Click type