procexec
Execute commands as new processes with options for background operation or suspended state initiation. Manage process execution directly from the agent-tool MCP server environment.
Instructions
Execute a command as a new process. Supports background execution and starting in suspended state. WARNING: This tool executes arbitrary commands on the host system. Use with caution. Use suspended=true to start a process in suspended state (Windows: CREATE_SUSPENDED, Linux: SIGSTOP). Use prockill with signal=cont to resume a suspended process.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| command | Yes | Command to execute (required) | |
| args | No | Command arguments | |
| cwd | No | Working directory (default: current directory) | |
| env | No | Environment variables in KEY=VALUE format. Inherits parent environment by default | |
| timeout_sec | No | Timeout in seconds (default 30, max 300). Ignored for background/suspended execution | |
| background | No | Start process in background and return PID immediately (default false) | |
| suspended | No | Start process in suspended state. Windows: CREATE_SUSPENDED, Linux: SIGSTOP. Implies background=true (default false) |