// 概要
Sandcastle は、分離された安全なサンドボックス環境内で AI コーディングエージェントをオーケストレーションするために設計された TypeScript ライブラリです。Docker、Podman、Vercel などの複数のプロバイダーをサポートし、エージェントの実行やブランチ戦略を効率的に管理します。サンドボックスのライフサイクル、git worktrees、自動コミットマージを処理することで、複雑なワークフローを簡素化します。
// 技術解説
Sandcastle は、 Git worktrees とコンテナ化された sandbox を活用し、安全で隔離された環境内で AI コーディングエージェントをオーケストレーションするために設計された TypeScript ライブラリです。変更の隔離、ブランチ戦略の管理、および複数のエージェント反復にわたる状態の永続化を構造化された方法で提供することで、自律型エージェントを安全に実行するという課題を解決します。このプロジェクトは、プロバイダーに依存しないアーキテクチャを通じて柔軟性を優先しており、開発者は Docker、 Podman、 Vercel を切り替えたり、特定のインフラストラクチャのニーズに合わせてカスタム sandbox プロバイダーを実装したりできます。
// 主要ハイライト
// ユースケース
// クイックスタート
開始するには、 npm 経由でパッケージをインストールし、 'npx sandcastle init' を実行して必要な設定ファイルをスキャフォールドします。生成された .sandcastle/.env ファイルで環境変数を設定し、 'npx tsx' を使用してメインの TypeScript ファイルを実行することでエージェントロジックを実行します。その後、コード内でエージェントと sandbox プロバイダーを定義して、 AI コーディングタスクのオーケストレーションを開始できます。