Agent that refuses to run commands without human approval

Intercepts shell commands before execution and presents them to a human operator for explicit approval or rejection, implementing a synchronous blocking pattern where the agent pauses execution flow until receiving user confirmation. The system captures command strings, displays them in a human-readable format, and only proceeds with subprocess execution after receiving affirmative input, preventing unintended or malicious command execution.

Formats and presents proposed shell commands to users in a clear, human-readable format that highlights command structure, arguments, and potential side effects. The system parses command strings into components, displays them with syntax highlighting or structured formatting, and provides context about what the command will do, enabling informed human decision-making before execution.

Provides an abstraction layer between an AI agent's decision-making logic and actual shell command execution, allowing the agent to request command execution through a standardized interface that enforces the approval gate. The system translates agent intent (expressed as command strings or structured requests) into shell invocations while maintaining control over execution timing and approval state.

Captures explicit user input (yes/no, approve/reject, or similar binary decision) from an interactive terminal session and translates it into execution control signals. The system blocks agent execution pending user response, handles input validation and retry logic for invalid responses, and propagates the approval decision back to the execution layer to either proceed or abort.

Executes approved shell commands in a subprocess with captured output streams (stdout/stderr), exit code tracking, and error handling. The system spawns a shell process, feeds the command string to it, captures execution results, and returns them to the agent or user, providing visibility into command success or failure without affecting the parent process.

Maintains state about whether each command has been approved, rejected, or is pending approval, and uses this state to control whether execution proceeds. The system tracks approval decisions throughout the command lifecycle, prevents execution of unapproved commands, and ensures commands execute only after explicit approval, implementing a state machine for command execution.