agent-run

Запускайте агента кодирования в изолированной среде с помощью крошечного отдельного бинарного файла с простой конфигурацией TOML.

Что такое agent-run?

agent-run — это инструмент командной строки, который запускает ИИ-агентов кодирования (например, pi, opencode, codex, claude) в изолированной среде с помощью bubblewrap. Он предоставляет простую конфигурацию на основе TOML для управления сетевым доступом, переменными окружения и точками монтирования, изолируя агентов от файловой системы хоста, кроме указанных путей.

Как использовать agent-run?

  1. 1Установка через Nix: nix run github:sin-ack/agent-run -- <команда>
  2. 2Или через Mise: mise use github:sin-ack/agent-run@latest
  3. 3Или вручную: скачайте бинарный файл из релизов, поместите в PATH, chmod +x
  4. 4Создайте TOML-конфигурационный файл в .agent-run/config.toml (или используйте стандартный)
  5. 5Запуск: agent-run <агент> (например, agent-run claude)

agent-run Ключевые возможности

  • Крошечный отдельный бинарный файл (<1 МБ) для GNU/Linux (aarch64 и x86_64)
  • Простая конфигурация на основе TOML с поддержкой JSON-схемы
  • Изолированное выполнение через встроенный bwrap (непривилегированные пространства имён пользователей)
  • Поддержка нескольких агентов кодирования: pi, opencode, codex, claude
  • Настраиваемые точки монтирования, переменные окружения и сетевой доступ для каждого инструмента
  • Файловая система хоста только для чтения по умолчанию с возможностью монтирования для записи

agent-run Сценарии использования

  • Запуск ИИ-агентов кодирования безопасно без запросов разрешений
  • Изоляция агентов от файлов не из проекта для предотвращения случайного повреждения
  • Тестирование или разработка агентов в контролируемой среде
  • Изоляция операций агентов с доступом к определённым директориям

agent-run Цены и бесплатный доступ

Модель оплаты agent-run: Бесплатно.

Этот инструмент полностью бесплатный

Open Source

Free

GNU General Public License v3

agent-run Плюсы и минусы

Плюсы

  • Чрезвычайно лёгкий и быстрый
  • Простая конфигурация с хорошими настройками по умолчанию
  • Гибкость для каждого инструмента: монтирование, окружение, сеть
  • Открытый исходный код и проверяемость

Минусы

  • Только Linux (требуется bwrap и непривилегированные пространства имён пользователей)
  • Не защищён от вредоносного кода (файловая система только для чтения, но доступны сокеты/сеть)
  • Ограничен поддерживаемыми агентами; для пользовательских агентов требуется ручная настройка
  • Нет поддержки наложения или параллельных агентов

Для чего лучше всего подходит agent-run?

  • Разработчики, использующие ИИ-агентов кодирования
  • Те, кому нужно простое изолирование без тяжёлых виртуальных машин
  • Пользователи, которых раздражают запросы разрешений
  • Пользователи Linux, ищущие лёгкий инструмент изоляции

Частые вопросы о agent-run