shell_execute
Execute shell commands with full system access for package installation, service management, file operations, and development tasks. Supports sudo for privileged operations and captures command output.
Instructions
Execute a shell command with full system access. Supports sudo for privileged operations.
Use this for:
Running system commands (apt, brew, yum, dnf, pacman, etc.)
Installing packages and dependencies
Managing services (systemctl, service, etc.)
File operations via shell utilities
Network operations (curl, wget, ssh, scp, etc.)
Git operations
Docker commands
Any other shell command
The command runs in /bin/bash by default. Output is captured and returned after completion. For long-running commands, use shell_execute_streaming instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes | The shell command to execute | |
| cwd | No | Working directory for the command (defaults to current directory) | |
| env | No | Environment variables to set for the command | |
| timeout | No | Timeout in milliseconds (default: 30000ms) | |
| shell | No | Shell to use (default: /bin/bash) | |
| sudo | No | Execute with sudo privileges. Use this for system-level operations like installing packages. |
Input Schema (JSON Schema)
{
"properties": {
"command": {
"description": "The shell command to execute",
"type": "string"
},
"cwd": {
"description": "Working directory for the command (defaults to current directory)",
"type": "string"
},
"env": {
"additionalProperties": {
"type": "string"
},
"description": "Environment variables to set for the command",
"type": "object"
},
"shell": {
"description": "Shell to use (default: /bin/bash)",
"type": "string"
},
"sudo": {
"default": false,
"description": "Execute with sudo privileges. Use this for system-level operations like installing packages.",
"type": "boolean"
},
"timeout": {
"description": "Timeout in milliseconds (default: 30000ms)",
"type": "number"
}
},
"required": [
"command"
],
"type": "object"
}