██╗ ██╗ ██████╗ ██╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗
╚██╗ ██╔╝██╔═══██╗██║ ██╔═══██╗██╔══██╗██╔═══██╗╚██╗██╔╝
╚████╔╝ ██║ ██║██║ ██║ ██║██████╔╝██║ ██║ ╚███╔╝
╚██╔╝ ██║ ██║██║ ██║ ██║██╔══██╗██║ ██║ ██╔██╗
██║ ╚██████╔╝███████╗╚██████╔╝██████╔╝╚██████╔╝██╔╝ ██╗
╚═╝ ╚═════╝ ╚══════╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝
AIを全力で走らせよう。ホームディレクトリはそのままに。
ドキュメント: yolobox.dev
変更履歴: CHANGELOG.md
Claude Code、Codex、Kimi Code、Gemini、Antigravity、OpenCode、Copilot、Pi、その他任意のAIコーディングエージェントを、ホームディレクトリを破壊することなく「yoloモード」で実行できます。
AIコーディングエージェントは、許可を求めずにコマンドを実行させると信じられないほど強力です。しかし、一度プロンプトを誤解して rm -rf ~ を実行されてしまえば、あとはバックアップから復元するだけです(ええ、そうですとも、バックアップなんてあるわけないですけどね笑)。
yolobox は、以下のようなコンテナ内でAIエージェントを実行します:
/Users/you/project のような実際のパスにマウントされますAIはサンドボックス内で完全に自由に暴れられます。実際のホームディレクトリは? 手出しできません。
# Install via Homebrew
brew install finbarr/tap/yolobox
# Or install via script
curl -fsSL https://raw.githubusercontent.com/finbarr/yolobox/master/install.sh | bash
Homebrew は bash と zsh の補完を自動的にインストールします。スクリプトによるインストールの場合は、shell completions を参照してください。
その後、任意のプロジェクトから:
cd /path/to/your/project
yolobox claude # Let it rip
他のAIショートカットも同じように動作します:
yolobox codex
yolobox gemini
yolobox kimi
yolobox agy
yolobox antigravity
yolobox opencode
yolobox copilot
yolobox pi
default_harness = "codex" を設定すると、素の yolobox で Codex が起動するようになります。手動シェルを使いたい場合は yolobox shell を、サンドボックス内で単一のコマンドを実行したい場合は yolobox run <cmd...> を使用してください。
インストールとランタイムの詳細は Installation & Setup に記載されています。コマンドの例は Commands にあります。
ベースイメージには、AI CLI、Codex および Claude ACP アダプター、Node.js、Python、Go、Bun、ビルドツール、Git、GitHub CLI、ripgrep、fd、fzf、jq、vim、RTK、およびその他一般的な実用ツールが含まれています。
別のものが必要ですか?エージェントには sudo があります。
yolobox 内では、サポートされている AI CLI は権限プロンプトをスキップするようにラップされています。確認なし、ガードレールなし。自然が意図したとおりの、純粋でフィルタリングされていない AI です。
ACP クライアントやエディターで使用する場合は、その stdio エージェントコマンドとして yolobox run codex-acp または yolobox run claude-agent-acp を使用してください。アダプターは互換性のあるエンジンをバンドルし、クライアントの権限モードを使用します。yolobox の CLI YOLO ラッパーおよび --no-yolo はそれらを制御しません。既存の設定同期と認証オプションが適用されます。起動例については ACP clients を参照してください。
イメージのプルおよびカスタムイメージのビルドの進捗は stderr に出力され、stdout とパイプされた stdin はコンテナコマンド用に残されます。これは ACP の起動中も同様です。
ツールの完全なリスト、YOLO モードのラッパー表、RTK の注意事項、npm パッケージの鮮度ポリシー、およびバンドルされた CLI のアップグレード動作については、What's in the Box を参照してください。
あるプロジェクトで追加のツールや環境変数が必要な場合は、ベースイメージ全体をフォークするのではなく、小さなプロジェクト設定を追加してください:
# .yolobox.toml
env = ["CODEX_HOME=/home/yolo/.codex-account"]
[customize]
packages = ["default-jdk", "maven"]
次に、通常どおり実行します:
yolobox run mvn --version
プロジェクトレベルのカスタマイズでは、ベースイメージの上に Dockerfile フラグメントを重ねることもできます。初回実行時に派生イメージがビルドされ、以降の実行ではベースイメージまたはカスタマイズ入力が変更されるまでそれが再利用されます。
env の値にはコンテナ内のパスを使用してください。これらの値は yolobox 内のプロセスに直接渡されるためです。env の値はそのままランタイムに渡され、その内容は一切解釈されません。
ホストが同じ名前で使用している値とは異なる値をサンドボックスに渡す場合 — 実際のトークンの代わりに読み取り専用トークンを渡す場合など — は、env_from_host(または --env-from-host KEY=HOST_VAR)でエイリアスを設定します:
# .yolobox.toml
env_from_host = ["GH_TOKEN=YOLOBOX_READONLY_GH_TOKEN"]
エイリアスはその変数を所有します。同じキーに対する自動パススルーと --gh-token を抑制し、ホスト変数が未設定の場合 yolobox は起動を拒否するため、置き換えられたトークンが誤って漏洩することは決してありません。
プロジェクトの環境設定については Configuration を、パッケージのインストール、Dockerfile フラグメント、再ビルドの動作、アップグレードの動作、完全にカスタムなイメージについては Project-Level Customization を参照してください。
yolobox setup # Configure global defaults
yolobox config # Show resolved config for this project
yolobox claude --docker --gh-token # Give the agent Docker and GitHub access
yolobox claude --claude-config --no-claude-auth # Share config, keep the box login independent
yolobox copilot --copilot-config # Share Copilot settings, login, and session history
yolobox codex --rtk # Enable RTK command-output compression
yolobox run --no-network make test # Run one command with no network
yolobox fork --name bruno codex # Give an agent its own project copy
yolobox upgrade # Update binary and pull the latest image
yolobox update-agents # Update AI CLIs and ACP adapters in the persistent box
yolobox reset --force # Remove yolobox volumes from the configured runtime
リセットは Docker、Podman、Apple container で動作します。既存の yolobox ボリュームのみを削除し、何も残っていない場合でも成功します。yolobox uninstall --force はバイナリとグローバル設定を削除する前にそれらのボリュームもクリーンアップします。ランタイムの失敗が発生するとアンインストールは停止し、再試行できます。アンインストール時に --keep-volumes を追加すると、ランタイムデータを保持できます。
イメージには OpenCode v2 (@opencode/cli) がバンドルされています。yolobox update-agents opencode も v2 をインストールし、ランチャーの競合を避けるために永続 npm プレフィックスから古い opencode-ai パッケージを先に削除します。インストールでは必要な postinstall スクリプトが明示的に許可されます。ユーザーがインストールした既存の v1 コピーは、更新するまでそのまま残ります。新しいイメージをプルするだけでは永続ツールは置き換わりません。
OpenCode v2 は opencode コマンドと既存の設定場所を維持します。切り替える前にセットアップをバックアップしてください。v1 のプラグインとサーバー API 統合には移行が必要です。詳細はアップストリームの移行ガイドを参照してください。
--claude-config は永続的な Claude 設定を段階的に同期し、ホストの ~/.claude/projects を読み書き可能でライブマウントするため、セッション再開履歴が最新の状態に保たれます。--no-claude-auth はボックスのログインを独立させますが、そのプロジェクト履歴のマウントを読み取り専用にはしません。--copilot-config は GitHub Copilot CLI に対して同じことを行います。永続的な ~/.copilot 設定、エージェント、スキル、MCP 設定を同期し、ホストの Copilot ログインを COPILOT_GITHUB_TOKEN として転送し、~/.copilot/session-state を読み書き可能でライブマウントします。ボックスの Copilot ログインを独立させるには --no-copilot-auth を追加してください。
自動 RTK セットアップは、初回の OpenCode 起動時を含め、プロンプトなしでサポート対象の CLI 統合を適用し、ボックス内から rtk telemetry enable で対話的にオプトインしない限りテレメトリを無効のままにします。
詳細なリファレンスは意図的にドキュメントサイトに置かれています:
fork、および例yolobox は人間ではなく AI エージェントのために設計されています。AI を起動して、作業を任せてください。
エージェントはコンテナ内で sudo を持っています。コンパイラ、データベース、パッケージ、またはフレームワークが必要なら、自分でインストールできます。名前付きボリュームがそのセットアップをセッション間で保持するため、README を何百行ものパッケージマトリクスにする必要はありません。プロジェクトを指定して、あとは任せてください。
同じランタイムとアーキテクチャを使用するボックスは、永続的なホーム、キャッシュ、および出力ボリュームを共有します。これには SELinux ホスト上の同時実行の rootless Podman ボックスも含まれます。これらの共有ボリュームなしで実行するには --scratch を使用してください。
yolobox は事故からの保護であり、魔法のコンテナエスケープ防止定理ではありません。
不注意による破壊的なコマンドから、ホームディレクトリ、SSH キー、ドットファイル、無関係なプロジェクト、およびホストファイルシステムの状態の大部分を保護するのに役立ちます。マウントしたプロジェクトディレクトリ、明示的に転送したシークレット、明示的にブリッジしたホストアクション、またはランタイムのエスケープ脆弱性からホストカーネルを保護するものではありません。
より厳格なボックスにするには、次のようなフラグを組み合わせてください:
yolobox claude --no-network --no-env-passthrough --readonly-project --exclude ".env*" --exclude "secrets/**"
敵対的なコードが心配な場合(不注意なコードではなく)は、rootless Podman や VM などのより強力な分離を使用してください。完全な脅威モデルと強化オプションは Security Model に記載されています。
make build
make test
make lint
make image
コントリビューターワークフロー、ドキュメントサイトのコマンド、バージョニング、リリースルールについてはContributingを参照してください。
MIT