チャットで指示するだけでコードを自動修正！クラウド上で動くAIコーディングエージェント — open-agents

vercel-labs/open-agentsTypeScript2.9k

Open Agentsは、チャットで指示を出すだけでAIがコードの変更・コミット・プルリクエストの作成まで自動で行ってくれるオープンソースのWebアプリケーションです。AIエージェントはVercel（Webサイトを公開するためのクラウドサービス）上でバックグラウンド実行され、専用のサンドボックス（隔離された安全な作業環境）の中でファイル編集やコマンド実行を行います。パソコンを開きっぱなしにしなくても、クラウド上でAIが作業を続けてくれるのが大きな特徴です。GitHubとの連携機能も備えており、リポジトリのクローンやブランチ作業、自動プルリクエスト作成まで対応しています。開発者が自分のプロジェクトに合わせてフォーク（コピーして改造）することを前提に設計されたテンプレートです。

🔥 なぜ話題？

Devin（自律型AIエンジニア）やClaude Codeなどに代表されるAIコーディングエージェントへの関心が急速に高まる中、Vercel公式ラボが提供するオープンソースの実装テンプレートとして注目を集めています。特に、エージェントとサンドボックスを分離するというアーキテクチャの設計思想が明確で、自分のプロジェクトに組み込みやすい点が開発者コミュニティで話題になっています。

💡 こう使える！

例えば、自分のWebサービスのGitHubリポジトリをOpen Agentsに接続し、チャット画面で『ログインページのデザインをモダンに変更して、バリデーションも追加して』と指示すると、AIがサンドボックス内でファイルを編集し、動作確認用のプレビューを表示し、完了後に自動でブランチを作成してプルリクエストまで出してくれます。自分のパソコンを閉じていてもクラウド上で作業が進みます。

ユースケース: チャットで指示するだけで、クラウド上のAIがコードの修正・作成からGitHubへのプルリクエスト作成まで自動で行ってくれる開発支援ツールを自前で構築したいとき。

AIエージェントがクラウド上でバックグラウンド実行されるため、パソコンを閉じても作業が続く
エージェントとサンドボックス（実行環境）が分離されており、それぞれ独立して進化・管理できる設計
GitHub連携で自動コミット・プッシュ・プルリクエスト作成まで対応
Vercelへのワンクリックデプロイに対応し、フォークして自分用にカスタマイズ可能
音声入力（ElevenLabs連携）やセッション共有など実用的な機能も搭載

GitHubで見る →

An open source template for building cloud agents.

技術情報

言語

TypeScript

ライセンス

MIT

最終更新

2026-04-16

スター数

2,915

フォーク数

314

Issue数

トピック

agentagentsaibackground-agents

技術詳細

アーキテクチャ

Open Agentsは3層構造で構成されています:

Web（UI） → Agent workflow（ワークフロー） → Sandbox VM（仮想マシン）

核心的な設計思想：エージェントはサンドボックスの外で動く

AIエージェントはVM（仮想マシン）の内部では動かない
エージェントはサンドボックスの外から、ファイル読み書き・編集・検索・シェルコマンドなどのツールを通じてサンドボックスを操作する
この分離により、エージェントの実行とサンドボックスのライフサイクルが独立し、それぞれ別々にスケール・進化可能

技術スタック

フレームワーク: Next.js（Webアプリ）
ランタイム: Vercel Workflow SDK（耐久性のあるワークフロー実行）
データベース: PostgreSQL（Neon推奨）
キャッシュ: Redis / Upstash KV（オプション、なければインメモリにフォールバック）
パッケージマネージャ: Bun
認証: Vercel OAuth + GitHub App（ユーザー認証フロー）
サンドボックス: Vercel Sandbox（スナップショットベースの復元機能付き）
音声入力: ElevenLabs（オプション）

リポジトリ構成

ディレクトリ	役割
`apps/web`	Next.jsアプリ、ワークフロー、認証、チャットUI
`packages/agent`	エージェント実装、ツール、サブエージェント、スキル
`packages/sandbox`	サンドボックス抽象化とVercelサンドボックス統合
`packages/shared`	共有ユーティリティ

エージェントのツール群

ファイル操作: ファイルの読み取り・編集
検索: コード検索
シェル: コマンド実行
タスク: タスク管理
スキル: 再利用可能なスキル
Web: Webアクセス

サンドボックスの仕様

ベーススナップショットから起動
公開ポート: 3000, 5173, 4321, 8000
一定時間非アクティブでハイバネート（休止）
スナップショットベースで復元可能

ワークフロー実行の特徴

チャットリクエストはインラインではなくワークフロー実行として開始される
各エージェントのターンは複数のワークフローステップにまたがって継続可能
アクティブな実行は既存ワークフローのストリームに再接続して再開可能
ストリーミング対応、キャンセル可能

GitHub連携機能

リポジトリのクローン
ブランチでの作業
自動コミット・プッシュ
自動プルリクエスト作成（設定による有効/無効切り替え）
プライベートリポジトリにも対応（GitHub Appインストールが必要）

その他の機能

セッション共有: 読み取り専用リンクで共有可能
音声入力: ElevenLabs APIによる音声文字起こし（オプション）

制約・注意点

自動コミット/PRはデフォルトでは常時ONではなく、ユーザーの設定に基づく
GitHub App連携なしでもデプロイは可能だが、リポジトリ操作機能は使えない
最低限PostgreSQLとJWE_SECRETがないとアプリが起動しない

インストール・クイックスタート

ローカルでのセットアップ

依存パッケージをインストール:

bun install

環境変数ファイルを作成:

cp apps/web/.env.example apps/web/.env

.envファイルに必要な値を設定（最低限以下が必要）:

POSTGRES_URL=（PostgreSQLの接続文字列）
JWE_SECRET=（下記コマンドで生成）
ENCRYPTION_KEY=（下記コマンドで生成）

シークレットの生成:

openssl rand -base64 32 | tr '+/' '-_' | tr -d '=\n'   # JWE_SECRET
openssl rand -hex 32                                    # ENCRYPTION_KEY

アプリを起動:

bun run web

Vercelへのデプロイ

README冒頭の「Deploy with Vercel」ボタンからワンクリックデプロイも可能。PostgreSQL（Neon）やRedis（Upstash）の連携も自動設定されます。