---
title: "Yolobox Configurator"
description: "Generate.yolobox.toml configuration files and CLI commands for yolobox, the container sandbox that lets AI coding agents run with full permissions while keeping your home directory safe."
url: https://findutils.com/developers/yolobox-configurator/
category: developers
---

# Yolobox Configurator

Generate.yolobox.toml configuration files and CLI commands for yolobox, the container sandbox that lets AI coding agents run with full permissions while keeping your home directory safe.

**Use this tool:** [Yolobox Configurator](https://findutils.com/developers/yolobox-configurator/)

## Programmatic access

- Browser-only: this tool works on a file, the DOM, or a browser API and has no REST or MCP id.

## Why Use the Yolobox Configurator?

Yolobox is a CLI tool that runs AI coding agents like Claude Code, OpenAI Codex, and Google Gemini inside isolated Docker containers. The AI gets sudo access and full freedom to install packages, write files, and run commands — while your home directory stays completely protected. This configurator helps you visually build.yolobox.toml project files and generate ready-to-use CLI commands without memorizing every flag and option. Whether you're setting up resource limits, forwarding SSH keys, adding custom packages, or configuring network isolation, this tool generates the exact configuration you need. It supports all yolobox features including multiple container runtimes (Docker, Podman, Apple containers), GPU passthrough, read-only project mounts, and custom Dockerfile fragments.

## Frequently Asked Questions

### What is yolobox?

Yolobox is an open-source CLI tool that runs AI coding agents inside isolated containers. It gives the AI full sudo access and auto-approval mode while protecting your home directory and system files from accidental damage.

### Which AI agents does yolobox support?

Yolobox supports Claude Code (with --dangerously-skip-permissions), OpenAI Codex, Google Gemini CLI, GitHub Copilot, and OpenCode. You can also run any custom command inside the container.

### Is yolobox safe to use?

Yolobox provides container-level isolation that protects against accidental filesystem damage. Your home directory is unmounted by default. For maximum security, use rootless Podman or VM-level isolation.

### Where does the.yolobox.toml file go?

Place.yolobox.toml in your project root directory. It configures project-specific settings like extra packages, mounts, environment variables, and network isolation. Global settings go in ~/.config/yolobox/config.toml.

### Do I need Docker installed?

Yes, yolobox requires a container runtime. Docker is the default, but it also supports Podman and Apple's container runtime. Install Docker Desktop or use rootless Podman for enhanced security.

### Does the Yolobox Configurator require a signup?

No. It is available with no signup and no usage limits. The .yolobox.toml and the CLI command are generated in your browser.

### What do the forwarding options control?

Which credentials and sockets the container may use from your host, such as an agent's login and the Docker socket. Mounts and environment variables live under Advanced Configuration. The defaults keep your home directory out of the sandbox; forward only what the agent needs.

### What do the security modes and resource limits do?

The security modes set how locked down the container is, and the resource limits cap CPU, memory, shared memory, and GPU use, so a runaway agent cannot exhaust the host.