runtm-ai/runtm

코딩 에이전트(coding agents)가 구축하고 배포할 수 있는 오픈 소스 샌드박스(sandboxes).

Claude Code, Cursor, Codex 및 기타 에이전트가 소프트웨어를 코딩하고 출시할 수 있는 격리된 환경을 실행하세요. 라이브 URL, 로그 및 미리보기를 제공합니다.

웹사이트 · 문서 · 시작하기

demo.mp4

yolo 에이전트를 위한 샌드박스 – 격리된 환경에서 에이전트가 모든 권한을 가지고 코딩할 수 있도록 합니다. 사용자의 기기나 클라우드에 위험을 주지 않습니다.
모든 코딩 에이전트 실행 – Claude Code, Cursor, Codex, Gemini CLI 등을 지원합니다. 선호하는 에이전트를 가져오세요.
즉각적인 실제 URL – 에이전트가 라이브 HTTPS 엔드포인트(endpoints)로 배포합니다. 테스트하고, 공유하고, 반복하세요.
로그 및 관찰 가능성 (observability) – 에이전트가 무엇을 구축했는지 확인하고, 문제를 디버깅하며, 수정 후 재배포하세요.

# 설치
uv tool install runtm
# 로컬 샌드박스 세션 시작
...

자동 중지 인프라를 통해 라이브 HTTPS 엔드포인트를 제공받습니다. 유휴 상태일 때는 머신이 종료되고, 트래픽이 발생하면 다시 깨어납니다.

OS 수준의 샌드박싱(sandboxing)을 통해 격리된 로컬 환경에서 AI 에이전트를 실행하세요:

# 샌드박스 시작 (첫 실행 시 종속성 자동 설치)
runtm session start
# 템플릿과 함께 시작
...

제공 기능:

OS 수준의 격리 (OS-level isolation) – bubblewrap (Linux) 또는 seatbelt (macOS)를 사용하여 빠르고 안전한 샌드박싱을 제공합니다.
즉각적인 시작 – 컨테이너가 필요 없이 100ms 미만으로 샌드박스가 시작됩니다.
멀티 에이전트 지원 – Claude Code, Codex, Gemini CLI 등과 함께 작동합니다.
지속 가능한 워크스페이스 (Persistent workspaces) – 세션을 중지하고 재개할 수 있으며 파일이 보존됩니다.

┌────────────┐ ┌─────────┐ ┌─────────┐ ┌──────────┐
│ Your Agent │ ──▶ │ Sandbox │ ──▶ │ Runtm │ ──▶ │ Live URL │
└────────────┘ └─────────┘ └─────────┘ └──────────┘

샌드박스 실행 – 에이전트가 격리된 워크스페이스를 할당받습니다.
에이전트 빌드 – 코딩, 종속성 설치, 테스트 실행을 위한 모든 권한을 가집니다.
배포 – 로그 및 미리보기가 포함된 실제 URL로 한 번의 명령으로 배포합니다.
반복 – 에이전트가 로그를 확인하고, 버그를 수정하고, 재배포할 수 있습니다.

로컬 샌드박스, 스캐폴딩(scaffolding) 및 배포를 위한 pip CLI (runtm) :

# 권장 사항
uv tool install runtm
# 대안
...

Go CLI (runtm-api

Go CLI (runtm-api)
)는 호스팅된 Cloud API (Cloud API)를 구동하는 AI 코딩 에이전트(AI coding agents)를 위한 별도의 더 가벼운 도구입니다:

curl -fsSL https://runtm.com/install | bash

이 도구는 JSON-in / JSON-out 방식을 사용하며, 안정적인 종료 코드 (exit codes)를 제공하고, Claude Code, Cursor, Codex를 위한 임베디드 스킬 파일 (embedded skill files)이 포함되어 있습니다. 자세한 내용은 Agent CLI 문서와 packages/agent/ 소스 코드를 참조하세요. pip 및 Go CLI는 동일한 API 키를 공유합니다.

명령 (Command)	설명 (Description)
runtm session start	새로운 샌드박스 (sandbox) 세션 시작
runtm session list	모든 샌드박스 목록 표시
runtm session attach <id>	샌드박스에 다시 연결
runtm session stop <id>	샌드박스 중지 (파일 보존)
runtm session destroy <id>	샌드박스 파괴 및 파일 삭제
runtm session deploy	샌드박스에서 라이브 URL로 배포
runtm init	새 프로젝트 초기화
runtm deploy	라이브 URL로 배포
runtm logs <id>	빌드, 배포 및 런타임 (runtime) 로그 확인
runtm status <id>	배포 상태 확인
runtm destroy <id>	배포 제거

전체 참조를 보려면 CLI 문서를 확인하세요.

Runtm은 완전히 셀프 호스팅 (self-hosted)할 수 있습니다. 셀프 호스팅 가이드를 참조하세요.

git clone https://github.com/runtm-ai/runtm.git
cd runtm
cp infra/local.env.example .env
...

참고: 셀프 호스팅 시에는 runtm이 아닌 runtm-dev를 사용하세요. 개발용 CLI (dev CLI)에는 샌드박스/에이전트 패키지가 포함되어 있습니다.

packages/
shared/ # 타입 (Types), 매니페스트 스키마 (manifest schema), 에러 (errors)
sandbox/ # 로컬 샌드박스 런타임 (Local sandbox runtime) (OS 레벨 격리)
...

전체 문서는 docs.runtm.com에서 확인할 수 있습니다:

개발 설정 및 가이드라인은 CONTRIBUTING.md를 참조하세요.

구성 요소 (Component)	라이선스 (License)
Server (api, worker, infra)	AGPLv3
...

이슈를 생성하거나 저희 Discord에 참여하세요.