discobox README

README проекта с github.com/discobox-ai/discobox. Одним файлом markdown: README.md.

Discobox

Discobox runs coding agents in disposable environments, each with its own copy of your source. Agents have passwordless sudo, nested Docker, a desktop, and a browser, and you can connect through a terminal, SSH, or your editor.

Run as many agent sessions against one repository as you like, each in its own box, while your own checkout stays yours. Source moves the way it already does with git: a box clones your repository, the agent commits, and you merge those commits back to your machine or push them as a pull request.

Claude Code, Codex, OpenCode, GitHub Copilot, omp, and pi are included; other terminal agents can be packaged in an image. Discobox supports macOS, Linux, and Windows and is under active development.

Public documentation: the manual.

Getting started

Install with Homebrew, on macOS or Linux:

brew install discobox-ai/tap/discobox

Or with the install script:

curl -sSfL https://discobox.ai | sh

On Windows, from PowerShell:

irm https://discobox.ai/install.ps1 | iex

Each of those installs the stable channel. Release channels covers the newer ones and how to pin a version.

For a guided first experience, run:

discobox run discobox-ai/tour

The tour opens full screen inside the box before your selected harness and needs no agent account. See the tour guide for continuing, exiting, replay and cleanup.

Open the console from your repository to create a box:

cd ~/src/my-project
discobox console

Work with the agent, have it commit the changes inside the box, and push them to a Git remote. Review and merge them through your usual Git workflow.

Discobox with an agent terminal, a shell, services, and forwarded ports

libkrun on Linux

Linux uses Docker by default. The optional libkrun provider needs a Linux amd64 server host with usable /dev/kvm, libkrun.so.1 on the dynamic loader's path, and passt on the server's PATH. The Discobox installer does not install these host dependencies. The server user needs read/write access to /dev/kvm (usually through the kvm group).

Install libkrun and passt using your distribution's packages where available. The library must export the APIs this server uses; an older package is rejected with the missing symbol's name. Alternatively, with Nix and flakes enabled, build the runtime from the published repository without a source checkout:

nix build github:discobox-ai/discobox#libkrun-runtime --out-link discobox-libkrun-runtime

Keep that output link so Nix retains the runtime. Configure the provider with absolute paths to discobox-libkrun-runtime/lib/libkrun.so.1 (libkrunPath) and discobox-libkrun-runtime/bin/passt (passtPath), on the server host:

discobox admin provider create --type libkrun \
  --libkrun-path "$(realpath discobox-libkrun-runtime/lib/libkrun.so.1)" \
  --passt-path "$(realpath discobox-libkrun-runtime/bin/passt)"

See discobox admin provider create --help=libkrun for all settings. Provider creation checks these software dependencies before accepting the provider; KVM is checked when a VM starts. After changing the server's PATH or dynamic loader environment, restart the server so its launchers inherit it. Guest images and the patched kernel are downloaded automatically on first use.

Many sessions, many boxes

An agent working in your checkout ties it up. You wait for it to finish, and a second agent in the same directory edits the same files, switches the same branch, and competes for the same ports and databases. Each box instead has its own copy of the source, its own git repository, and its own services and Docker. You can start a bug fix, a feature, and an experiment you may throw away, each in its own box, and keep working in your own checkout while they run.

discobox run -d . 'fix the flaky retry test'
discobox run -d . 'add pagination to the users endpoint'
discobox run -d . 'try replacing the ORM with sqlc'
discobox ls

It is just git

There is no special sync layer. Give an agent a computer of its own and it needs the source the way you would on a new machine: clone the repository, make changes, then merge them back or open a pull request. A box does exactly that, so the only questions are where it clones from and where the work goes.

flowchart LR
  repo["Your repository"] -- "clone" --> a["Box A"]
  repo -- "clone" --> b["Box B"]
  repo -- "clone" --> c["Box C"]
  a -- "git push" --> host["Your Git host: a branch or pull request"]
  b -- "git push" --> host
  c -- "git push" --> host

Where a box clones from. The source you name first, . for the repository you are in, at the commit you have checked out. Only committed work goes in: uncommitted changes stay behind unless you pass --include-dirty, and then they arrive as uncommitted changes on that same commit. In the box, origin is your repository, read-only: the agent can fetch from it but cannot push to it, and nothing it does touches your files. -i brings more sources into the same box, either another local checkout or a remote URL, whose origin is then that remote.

Where the work goes. The agent commits in the box and pushes to a Git remote. Open a pull request or fetch and merge that branch on your machine.

Working with a box

Isolation and credentials

On Linux, a fresh installation uses the existing libkrun microVM provider when KVM is usable, passt is on PATH, and libkrun.so.1 is available to the dynamic loader with block and network support (currently linux/amd64). Otherwise it uses Docker and the launching CLI warns why: sandboxes share the host kernel without a VM isolation boundary. The choice is saved with the default pool; existing installations keep their provider. macOS uses Virtualization.framework and Windows uses WSL.

Agents can install packages and run commands inside the box without approval prompts. Outbound traffic passes through a proxy with a separate mTLS identity for each box, destination policy, and request auditing.

Managed credentials remain outside the box. Agents receive placeholders called sentinels; the proxy substitutes the real credential only on the routes its secret and its binding allow, and refuses a request on any other. A secret is bound to a box, a harness or a whole project (discobox secret bind). An agent can request additional access, which a human approves with routes and an expiry.

See discobox.ai for the full overview and architecture.

Release channels

Every release is published as a prerelease and marked stable by hand later, once it has been in use for a while. The newest green commit on main is built too, about a dozen times a day. That gives four channels, each newer and less proven than the one before:

latest was the beta channel's name and still installs it, saying so.

Homebrew

The tap carries stable and beta as two formulae. discobox-beta installs beside discobox and runs under its own name, so you can keep both:

brew install discobox-ai/tap/discobox       # stable, runs as discobox
brew install discobox-ai/tap/discobox-beta  # beta, runs as discobox-beta

The two share one state directory, one configuration, and one downloaded server, so their servers cannot run at the same time; stop one before starting the other. There is no edge or main formula — use the install script for those. The beta formula used to be discobox-dev; it still links a discobox-dev command, which says to run discobox-beta instead.

Install script

curl -sSfL https://discobox.ai | sh                       # stable
curl -sSfL https://discobox.ai | sh -s -- --channel beta  # beta
curl -sSfL https://edge.discobox.ai | sh                  # edge
curl -sSfL https://main.discobox.ai | sh                  # main
irm https://discobox.ai/install.ps1 | iex                 # stable
irm https://edge.discobox.ai/install.ps1 | iex            # edge
irm https://main.discobox.ai/install.ps1 | iex            # main
$env:DISCOBOX_CHANNEL = 'beta'; irm https://discobox.ai/install.ps1 | iex

Unlike the tap, the script installs whichever channel you ask for as discobox, over whatever is already there. Pass --dir or -InstallDir to keep two of them side by side.

Pin one release instead of a channel:

curl -sSfL https://discobox.ai | sh -s -- --version v0.10.1
& ([scriptblock]::Create((irm https://discobox.ai/install.ps1))) -Version v0.10.1

Both scripts take --channel, --version, --dir, and --stage — -Channel, -Version, -InstallDir, -Stage, and -NoModifyPath in PowerShell — and read DISCOBOX_CHANNEL, DISCOBOX_VERSION, DISCOBOX_INSTALL_DIR, and DISCOBOX_INSTALL_STAGE from the environment, which is the only way to pass an option through iex. A flag beats the environment, and a version beats a channel. install.sh --help lists the rest; install.ps1 documents them in its header comment.

Either way you install the client only. The Discobox server is a separate program, downloaded the first time something needs one locally and checked against the digests the client carries; --stage fetches it during the install instead of on first use.

Uninstalling

To remove Discobox's data, downloaded servers and images, and configuration, run discobox admin uninstall. It lists what it will delete and asks first, and leaves the discobox command for your package manager to remove.

Community

Ask questions, share what you are building, and follow development on Discord.

License

See LICENSE.

discobox (discobox-ai/discobox)

Ищем в базе…

Что это такое?Discobox запускает агентов для программирования (Claude Code, Codex, OpenCode, GitHub Copilot и других) в одноразовых песочницах. У каждого агента есть собственная полная копия вашего исходного кода, поэтому агенты не могут мешать ни друг другу, ни вашей рабочей копии.
Это какой-то особый инструмент синхронизации или тут просто git?Внутри это обычный git: бокс клонирует ваш репозиторий, агент делает коммиты внутри него, а вы переносите эти коммиты обратно командой 'discobox apply' или отправляете их как pull request. Собственного слоя синхронизации нет.
Как установить и начать пользоваться?Установите через Homebrew на macOS/Linux, с помощью скрипта установки или из PowerShell на Windows, затем откройте консоль из своего репозитория, чтобы создать бокс и начать работать внутри него с агентом.
На каких технологиях изоляции оно держится?Discobox изолирует каждый бокс с помощью виртуальных машин и контейнеров, внутри доступен вложенный Docker, а трафик идёт через прокси с идентификацией по mTLS, отдельной для каждого бокса.
Что будет, если два бокса внесут конфликтующие изменения?Перенос обратно командой 'discobox apply' проходит только в том случае, если каждый коммит применяется без конфликтов через cherry-pick. При конфликте ничего не меняется, и команда выводит git-команду для воспроизведения конфликта, чтобы разрешить его вручную. Также переносится только зафиксированная работа: бокс с незафиксированными изменениями пропускается.
На каких операционных системах это работает?Discobox поддерживает macOS, Linux и Windows.
Как защищены мои учётные данные и токены Git-хостингов?Агенты никогда не видят настоящие секреты напрямую: они получают заглушки-маркеры («сентинелы»). Прокси подставляет настоящие учётные данные только на те маршруты, которые разрешает привязка секрета, и отклоняет запросы на любые другие маршруты.
Как подключиться к запущенному боксу?Через терминал или SSH (конфигурация SSH синхронизируется автоматически, так что 'ssh $DISCOBOXID' просто работает), через интеграцию с редактором, например 'discobox tools vscode' или 'discobox tools zed', либо через VNC/noVNC для графического рабочего стола бокса и браузера.
Можно ли одновременно запускать несколько боксов для одного репозитория?Да, можно создать сколько угодно боксов для одного репозитория. У каждого будет своя копия исходного кода, собственный git-репозиторий, сервисы и Docker, а ваша рабочая копия останется нетронутой.
Какие каналы релизов доступны?stable — самая новая версия, помеченная как stable после проверки в реальных условиях; latest — самый новый релиз с тегом, стабильный или нет; edge — самая новая сборка, включая альфа-, бета- и релиз-кандидаты.
Могут ли боксы синхронизировать работу друг с другом?Боксы друг друга напрямую не видят. Однако после того как работа одного бокса применена к вашему репозиторию, другие боксы могут подтянуть её, выполнив внутри себя 'git fetch origin && git rebase origin/ '.
Какие есть похожие проекты?agentbox, billion-context, OpenAgentCore, gastown, headroom, shipyard, codex, agentreach
Автор
discobox-ai
Размер
51.2 MB
Звёзды
123
Возраст
4 мес
Коммиты · 90 дней