# Agent Safehouse

## Docs

- [Introduction](https://mintlify.wiki/eugene1g/agent-safehouse/introduction.md): Sandbox your LLM coding agents on macOS with practical least privilege
- [Installation](https://mintlify.wiki/eugene1g/agent-safehouse/installation.md): Install Agent Safehouse CLI and configure shell functions
- [Quickstart](https://mintlify.wiki/eugene1g/agent-safehouse/quickstart.md): Get Agent Safehouse running in 5 minutes
- [Overview](https://mintlify.wiki/eugene1g/agent-safehouse/concepts/overview.md): What Agent Safehouse is and how it works
- [Design Philosophy](https://mintlify.wiki/eugene1g/agent-safehouse/concepts/philosophy.md): Principles and tradeoffs behind Agent Safehouse
- [Isolation Models](https://mintlify.wiki/eugene1g/agent-safehouse/concepts/isolation-models.md): Comparing VMs, containers, and Safehouse
- [Default Assumptions](https://mintlify.wiki/eugene1g/agent-safehouse/concepts/default-assumptions.md): What Safehouse allows and denies by default
- [Basic Usage](https://mintlify.wiki/eugene1g/agent-safehouse/usage/basic-usage.md): Common workflows and usage patterns for Agent Safehouse
- [CLI Options Reference](https://mintlify.wiki/eugene1g/agent-safehouse/usage/cli-options.md): Complete reference for all Safehouse command-line flags and options
- [Shell Functions](https://mintlify.wiki/eugene1g/agent-safehouse/usage/shell-functions.md): Recommended shell wrapper patterns for convenient Safehouse usage
- [Workdir Config Files](https://mintlify.wiki/eugene1g/agent-safehouse/usage/workdir-config.md): Use .safehouse config files for per-project sandbox configuration
- [Policy Architecture](https://mintlify.wiki/eugene1g/agent-safehouse/advanced/policy-architecture.md): Understanding Safehouse's policy assembly, layer ordering, and dependency system
- [Customization](https://mintlify.wiki/eugene1g/agent-safehouse/advanced/customization.md): Machine-local overrides, --append-profile, and when to use each approach
- [Custom Profiles](https://mintlify.wiki/eugene1g/agent-safehouse/advanced/custom-profiles.md): How to write .sb files, matchers (literal/subpath/regex), and real examples
- [Distribution](https://mintlify.wiki/eugene1g/agent-safehouse/advanced/distribution.md): Understanding dist/ artifacts, single-file dist/safehouse.sh, and generation process
- [Debugging Sandbox Denials](https://mintlify.wiki/eugene1g/agent-safehouse/operations/debugging.md): Learn how to diagnose and resolve sandbox denial events using macOS log tools
- [Testing](https://mintlify.wiki/eugene1g/agent-safehouse/operations/testing.md): Run Agent Safehouse policy tests and validate sandbox behavior
- [Contributing](https://mintlify.wiki/eugene1g/agent-safehouse/operations/contributing.md): Development workflow, profile authoring guidelines, and pull request process
- [Agent Compatibility Overview](https://mintlify.wiki/eugene1g/agent-safehouse/agents/overview.md): Complete list of coding agents supported by Agent Safehouse with sandboxing status and integration details
- [Aider](https://mintlify.wiki/eugene1g/agent-safehouse/agents/aider.md): Python-based AI coding assistant with terminal UI, Streamlit web GUI, and extensive LLM provider support
- [Amp](https://mintlify.wiki/eugene1g/agent-safehouse/agents/amp.md): Clipboard-aware coding agent with Bun runtime
- [Auggie (Augment Code)](https://mintlify.wiki/eugene1g/agent-safehouse/agents/auggie.md): Closed-source model-agnostic AI coding agent with extensive cloud integration
- [Claude Code](https://mintlify.wiki/eugene1g/agent-safehouse/agents/claude-code.md): Anthropic's proprietary CLI/TUI agent with comprehensive sandboxing
- [Cline](https://mintlify.wiki/eugene1g/agent-safehouse/agents/cline.md): VS Code extension AI coding assistant with browser automation
- [Codex (OpenAI)](https://mintlify.wiki/eugene1g/agent-safehouse/agents/codex.md): Rust-based coding agent with built-in macOS Seatbelt sandboxing
- [GitHub Copilot CLI](https://mintlify.wiki/eugene1g/agent-safehouse/agents/copilot-cli.md): GitHub's AI command-line assistant
- [Cursor Agent](https://mintlify.wiki/eugene1g/agent-safehouse/agents/cursor-agent.md): Cursor IDE's built-in AI agent mode
- [Droid (Factory CLI)](https://mintlify.wiki/eugene1g/agent-safehouse/agents/droid.md): Model-agnostic AI agent with hierarchical security policies
- [Gemini CLI](https://mintlify.wiki/eugene1g/agent-safehouse/agents/gemini-cli.md): Google's Gemini-powered command-line agent
- [Goose](https://mintlify.wiki/eugene1g/agent-safehouse/agents/goose.md): Block's open-source Rust agent with native keyring integration
- [Kilo Code](https://mintlify.wiki/eugene1g/agent-safehouse/agents/kilo-code.md): VS Code extension (Cline fork) with cloud services and autocomplete
- [OpenCode](https://mintlify.wiki/eugene1g/agent-safehouse/agents/opencode.md): Open-source CLI/TUI agent with minimal dependencies
- [Pi](https://mintlify.wiki/eugene1g/agent-safehouse/agents/pi.md): Minimal TypeScript coding agent with custom TUI
- [Commands](https://mintlify.wiki/eugene1g/agent-safehouse/reference/commands.md): Complete reference of safehouse command modes and usage patterns
- [CLI Options](https://mintlify.wiki/eugene1g/agent-safehouse/reference/options.md): Complete reference of all safehouse CLI flags and parameters
- [Integrations](https://mintlify.wiki/eugene1g/agent-safehouse/reference/integrations.md): Optional features you can enable with --enable to extend sandbox capabilities
- [Base Profile](https://mintlify.wiki/eugene1g/agent-safehouse/reference/profiles/base.md): Core definitions, HOME_DIR macro, and helper functions shared by all profiles
- [System Runtime Profile](https://mintlify.wiki/eugene1g/agent-safehouse/reference/profiles/system-runtime.md): Process execution, system paths, device nodes, and baseline mach services for agent workflows
- [Toolchain Profiles](https://mintlify.wiki/eugene1g/agent-safehouse/reference/profiles/toolchains.md): Language runtime permissions for Node.js, Python, Rust, Go, Java, Ruby, and more
- [Integration Profiles](https://mintlify.wiki/eugene1g/agent-safehouse/reference/profiles/integrations.md): Git, Docker, Kubernetes, SSH, clipboard, and other development tool integrations
- [Prior Art](https://mintlify.wiki/eugene1g/agent-safehouse/reference/prior-art.md): Related projects, learning resources, and sandbox references
- [Troubleshooting](https://mintlify.wiki/eugene1g/agent-safehouse/reference/troubleshooting.md): Common issues, sandbox denials, and debugging techniques
- [FAQ](https://mintlify.wiki/eugene1g/agent-safehouse/reference/faq.md): Frequently asked questions about Agent Safehouse