Runtm CLI
Runtm запускает Claude Code, Codex и других агентов в песочнице и выкладывает собранное приложение на живой HTTPS-адрес
- 303 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент в песочнице работает с полными правами: ставит пакеты, запускает код и сетевые вызовы внутри сессии
- Команда `runtm session deploy` публикует проект на живом HTTPS-адресе, то есть код и данные видны любому, у кого есть ссылка
- Облачные функции используют API-ключ, который попадает в окружение агента и скриптов
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/runtmОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент в песочнице работает с полными правами: ставит пакеты, запускает код и сетевые вызовы внутри сессии
- Команда `runtm session deploy` публикует проект на живом HTTPS-адресе, то есть код и данные видны любому, у кого есть ссылка
- Облачные функции используют API-ключ, который попадает в окружение агента и скриптов
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Runtm — открытый набор для запуска кодинг-агентов в песочнице. Команда `runtm session start` поднимает локальную сессию, в которой агент свободно ставит зависимости, пишет код и гоняет тесты. Изоляция работает на уровне ОС: bubblewrap на Linux и seatbelt на macOS, контейнеры не нужны. README называет запуск песочницы быстрее 100 мс. Другого агента выбирает флаг `--agent codex`, шаблон проекта флаг `--template web-app`. Остановленная сессия сохраняет файлы, а `runtm session attach <id>` возвращает в нее. Готовое приложение выкладывает `runtm session deploy`: оно получает живой HTTPS-адрес на инфраструктуре с автоостановкой, при простое машина засыпает и просыпается по трафику. Для проекта вне сессии есть `runtm init` и `runtm deploy`, а `runtm logs <id>`, `runtm status <id>` и `runtm destroy <id>` показывают журналы, состояние и сносят выкладку. Агент видит логи сам, исправляет ошибку и выкладывает заново. Отдельный CLI на Go, `runtm-api`, рассчитан на агентов, которые работают с облачным API: ввод и вывод в JSON, стабильные коды выхода и встроенные файлы скиллов для Claude Code, Cursor и Codex. Оба CLI используют один API-ключ. Сервер можно развернуть у себя через `docker compose`, тогда вместо `runtm` вызывают `runtm-dev`.
Для кого. Разработчикам, которые отдают Claude Code, Cursor или Codex полные права на сборку и тесты и хотят делать это в песочнице, а результат показывать по живой ссылке.
Подходит, если
- Агенту нужны полные права для установки зависимостей и запуска тестов, но не на вашей машине
- Результат надо показать коллегам по живому HTTPS-адресу после `runtm session deploy`
- Агент должен сам читать логи выкладки и перевыкладывать исправление (`runtm logs`, `runtm status`)
- Облачным API управляет агент, и ему нужен JSON на входе и выходе со стабильными кодами выхода (`runtm-api`)
- Исходники нельзя отдавать стороннему хостингу, поэтому сервер разворачивают у себя через `docker compose`
Не подходит, если
- Нужна только изоляция команд без выкладки: хватит отдельной песочницы вроде Fence
- Рабочая машина на Windows: в README упомянуты только bubblewrap для Linux и seatbelt для macOS
- Проект не должен попадать в сеть: выкладка публикует его по живому адресу
Пример запроса к агенту
Запусти `runtm session start --template web-app`, собери в песочнице простой API на FastAPI и выложи его через `runtm session deploy`Ограничения
- Выкладка идет на хостинг Runtm, оба CLI используют общий API-ключ. Свой сервер поднимается через `docker compose`, и вызывать тогда нужно `runtm-dev`: README советует его вместо `runtm` при самохостинге.
- Песочница опирается на bubblewrap на Linux и seatbelt на macOS, про Windows README молчит.
- Лицензии разные: сервер под AGPLv3, CLI под Apache 2.0, шаблоны под MIT.
- Агент в песочнице действует с полными правами, поэтому состав проекта внутри сессии он меняет без ограничений.
Как отключить. Команда `runtm session stop <id>` останавливает песочницу и сохраняет файлы, `runtm session destroy <id>` удаляет ее вместе с файлами. Выкладку снимает `runtm destroy <id>`. Сам CLI удаляется командой `uv tool uninstall runtm`.
Частые вопросы
Как поставить Runtm?
Командой `uv tool install runtm`, запасные способы: `pipx install runtm` и `pip install runtm`. Затем `runtm session start` запускает локальную песочницу, а `runtm session deploy` выкладывает проект на живой адрес.
Чем `runtm` отличается от `runtm-api`?
`runtm` написан на Python и нужен для локальных песочниц, шаблонов и выкладки. `runtm-api` написан на Go, легче и создан для агентов, которые работают с облачным API. Он ставится командой `curl -fsSL https://runtm.com/install | bash`, а ключ у обоих общий.
Какие агенты работают в песочнице Runtm?
Claude Code, Codex, Gemini CLI и другие: нужный агент выбирает флаг `--agent`, например `--agent codex`. Cursor тоже назван в README.
Из чего сделана изоляция?
Из средств ОС: bubblewrap на Linux и seatbelt на macOS. Контейнеры для локальной песочницы не нужны.
Можно ли развернуть Runtm у себя?
Да. Клонируйте репозиторий, скопируйте `infra/local.env.example` в `.env`, выполните `./scripts/dev.sh setup` и `docker compose -f infra/docker-compose.yml up -d`, затем вызывайте `runtm-dev`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыAgentBox запускает Claude Code, Codex и Open Code в отдельных виртуальных машинах: на вашем ПК, своем сервере или в облаке.
Песочница на Rust для параллельных кодинг-агентов: у каждого свое рабочее пространство и общий проект, правки публикуются разом.
Самостоятельно хостится центр управления агентами: Claude Code, Codex, Copilot, OpenCode и Pi с телефона, десктопа и терминала
Платформа на вашем сервере, которая выдает каждому агенту свою Linux-машину с SSH и MCP-инструментами для команд и файлов
Docker-песочница для кодинг-агентов: образ на Debian с Copilot CLI, Codex и Pi, а доступ по SSH, RDP и Docker включается флагами.
Команда vp run запускает Claude Code, Codex, Gemini и другие CLI-агенты в контейнерах Docker или Podman
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| Runtm (эта карточка) | да | 303 | |
| Fence | да | 1 013 | запускает команды и агентов в песочнице с блокировкой сети по умолчанию, но выкладкой на живой адрес не занимается |
| Vercel Sandbox | нет | 219 | официальный скилл Vercel по изолированным микро-ВМ для кода агента, а Runtm привязывает песочницу к собственной выкладке |
Коротко о README
README объясняет идею в одной строке и поясняет, зачем нужны песочницы. Быстрый старт занимает четыре команды, дальше идут локальные сессии с описанием изоляции и схема «агент, песочница, Runtm, живой адрес». Затем описаны установка двух CLI, таблица команд, самохостинг и структура пакетов.