📁 Subsystem Deep Dive

utils/sandbox/

📁 utils/sandbox/ 📄 8 files

Tutorial: sandbox

This project acts as a security guard for the Claude CLI, ensuring that generated commands run inside a safe, isolated container (the sandbox). It translates user-friendly settings into strict execution rules, checks if the computer has the necessary tools and environment to run safely, and cleans up any dangerous files left behind after a task is finished.

flowchart TD A0["Sandbox Adapter Manager"] A1["Configuration Translation"] A2["Path Resolution & Normalization"] A3["Command Execution Wrapping"] A4["Security Scrubbing & Mitigation"] A5["Environment & Dependency Checking"] A6["UI Presentation Utilities"] A0 -->|"Generates config via"| A1 A0 -->|"Validates system with"| A5 A0 -->|"Delegates execution to"| A3 A0 -->|"Triggers cleanup via"| A4 A1 -->|"Normalizes paths using"| A2 A1 -->|"Identifies threats for"| A4 A6 -->|"Cleans output from"| A0

Chapters

  1. Sandbox Adapter Manager
  2. Environment & Dependency Checking
  3. Configuration Translation
  4. Path Resolution & Normalization
  5. Command Execution Wrapping
  6. Security Scrubbing & Mitigation
  7. UI Presentation Utilities

Generated by Code IQ

Files in this section

01_sandbox_adapter_manager.md
Chapter 1: Sandbox Adapter Manager
Welcome to the Sandbox project!
02_environment___dependency_checking.md
Chapter 2: Environment & Dependency Checking
Welcome back! In Chapter 1: Sandbox Adapter Manager, we introduced the Sandbox Manager, the "diplomat" that helps Claud…
03_configuration_translation.md
Chapter 3: Configuration Translation
Welcome back! In Chapter 2: Environment & Dependency Checking, we performed our "pre-flight checklist" to ensure the co…
04_path_resolution___normalization.md
Chapter 4: Path Resolution & Normalization
Welcome back! In Chapter 3: Configuration Translation, we learned how to turn a user's friendly settings.json into a st…
05_command_execution_wrapping.md
Chapter 5: Command Execution Wrapping
Welcome back! In Chapter 4: Path Resolution & Normalization, we ensured that all file paths (like ~/project) were conve…
06_security_scrubbing___mitigation.md
Chapter 6: Security Scrubbing & Mitigation
Welcome back! In Chapter 5: Command Execution Wrapping, we learned how to wrap a command in a "Biohazard Box" so it cou…
07_ui_presentation_utilities.md
Chapter 7: UI Presentation Utilities
Welcome to the final chapter of our tutorial series!