Run AI agents in a sandboxed macOS user account with restricted permissions. Ideal for operations teams needing to execute Claude Code, OpenAI Codex, Google Gemini, and shell commands safely. Connects to macOS environments and AI agent workflows.
git clone https://github.com/webcoyote/sandvault.gitRun AI agents in a sandboxed macOS user account with restricted permissions. Ideal for operations teams needing to execute Claude Code, OpenAI Codex, Google Gemini, and shell commands safely. Connects to macOS environments and AI agent workflows.
[{"step":"Prepare the command or AI agent for execution. Ensure it includes all necessary arguments and paths. For example, if running a Python script, specify the script path and any required flags.","tip":"Use absolute paths for all file operations to avoid ambiguity in the sandbox. Test the command in a non-sandboxed environment first to verify it works as expected."},{"step":"Identify restricted paths or actions. List directories, files, or system resources the agent should not access (e.g., `/etc`, `/usr`, `network.local`).","tip":"Start with a restrictive policy and loosen permissions only if necessary. Use SandVault's policy templates for common restrictions (e.g., 'no_system_access', 'no_network_access')."},{"step":"Set resource limits (CPU, memory, disk I/O) to prevent the agent from consuming excessive system resources. Adjust these based on the complexity of the task.","tip":"For CPU-intensive tasks, set a limit slightly below your system's max capacity to avoid system slowdowns. Monitor the agent's performance in the sandbox to fine-tune limits."},{"step":"Execute the command or agent using SandVault. Monitor the process in real-time to catch any permission denials or resource limit breaches immediately.","tip":"Use SandVault's logging feature to capture all actions and errors. Review the log after execution to identify any issues or areas for policy improvement."},{"step":"Review the execution report. Analyze any denied actions or resource limits reached to adjust the sandbox policy or command for future runs.","tip":"If the agent fails due to resource limits, increase the limits incrementally. If it fails due to permission denials, refine the allowed paths or actions in the policy."}]
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/webcoyote/sandvaultCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Run the following AI agent or shell command in a sandboxed macOS user account with restricted permissions: [COMMAND_OR_AGENT]. Ensure the sandbox prevents access to [LIST_OF_RESTRICTED_PATHS_OR_ACTIONS]. Monitor the process and terminate it if it attempts to exceed [ALLOWED_RESOURCES]. Provide a detailed log of all actions taken, including any permission denials or resource limits reached. Use the SandVault tool to execute this safely.
### SandVault Execution Report **Command Executed:** `python3 /Users/devops/ai_agent.py --analyze-logs --output /tmp/analysis.json` **Sandbox User:** `sandbox_ai_agent_123` **Start Time:** 2024-05-20 14:30:00 UTC **End Time:** 2024-05-20 14:35:12 UTC **Status:** Completed (Resource Limits Reached) #### Actions Taken: 1. **File Access:** - Read `/var/log/system.log` → **Allowed** - Write `/tmp/analysis.json` → **Allowed** - Read `/etc/passwd` → **Denied** (Permission: `sandbox_ai_agent_123` lacks read access to `/etc`) - Attempt to write to `/usr/local/bin` → **Denied** (Sandbox policy blocks system directories) 2. **Network Access:** - Outbound connection to `api.github.com` → **Allowed** (Required for GitHub API calls) - Outbound connection to `192.168.1.1` (local NAS) → **Denied** (Sandbox restricts local network access) 3. **Resource Limits:** - CPU usage peaked at 85% (Limit: 90%) → **No termination** - Memory usage: 450MB (Limit: 500MB) → **No termination** - Disk writes: 12MB (Limit: 100MB) → **No termination** 4. **Termination Events:** - None. Process completed within allotted resources. #### Output Summary: - Generated `/tmp/analysis.json` with 47 entries of log analysis. - Detected 3 critical errors in system logs (see `critical_errors` field in output). - No unauthorized actions detected. **Recommendation:** Increase memory limit to 750MB for similar future tasks to avoid resource-related interruptions.
Cloud ETL platform for non-technical data integration
IronCalc is a spreadsheet engine and ecosystem
Get more done every day with Microsoft Teams – powered by AI
Customer feedback management made simple
Enterprise workflow automation and service management platform
Automate your spreadsheet tasks with AI power
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan