// summary
Sandcastle is a TypeScript library designed to orchestrate AI coding agents within isolated, secure sandbox environments. It supports multiple providers including Docker, Podman, and Vercel to manage agent execution and branch strategies effectively. The library simplifies complex workflows by handling sandbox lifecycles, git worktrees, and automated commit merging.
// technical analysis
Sandcastle is a TypeScript library designed to orchestrate AI coding agents within secure, isolated environments by leveraging Git worktrees and containerized sandboxes. It solves the challenge of safely executing autonomous agents by providing a structured way to isolate changes, manage branch strategies, and persist state across multiple agent iterations. The project prioritizes flexibility through a provider-agnostic architecture, allowing developers to swap between Docker, Podman, and Vercel, or implement custom sandbox providers to suit specific infrastructure needs.
// key highlights
// use cases
// getting started
To begin, install the package via npm and run 'npx sandcastle init' to scaffold the necessary configuration files. Configure your environment variables in the generated .sandcastle/.env file, then execute your agent logic by running the main TypeScript file using 'npx tsx'. You can then define your agent and sandbox provider in your code to start orchestrating your AI coding tasks.