orbit-shuttle

로컬 프로젝트를 한 줄로 클라우드 개발환경에 올리고, 브라우저에서 코딩 에이전트와 라이브 프리뷰로 계속 개발합니다.

npx orbit-shuttle            # 프로젝트 폴더에서 — 인터뷰 → 로그인(브라우저 1회) → 샌드박스 → 작업실·프리뷰 링크

무엇이 올라가나

• 소스 트리(tar). node_modules, .git, dist, .env*(example 제외), 키 파일 등 기본 제외 + .gitignore
• .env 는 이름만 올라갑니다(값은 가려짐). 비밀값은 작업실에서 따로 넣습니다.
• 크기: 올리기 전에 원본 기준으로 재서 200MB 를 넘으면 큰 항목을 보여 주고, 1GB 를 넘으면 멈춥니다. .orbitignore(gitignore 형식)로 빼거나 프로젝트 폴더 안에서 실행하세요 — 상위 폴더에서 실행하면 형제 폴더까지 올라갑니다.
• 인터뷰 에이전트가 읽는 파일도 같은 규칙입니다(비밀 파일 거부, 루트 밖 거부).

명령

orbit up [--yes] [--no-interview] [--name <n>] [--instance <t>]
         [--provider cloudflare|host:<name>] [--agent claude-sdk|acp:gemini|acp:codex|acp:claude] [--open]
orbit status · orbit open [--preview] · orbit stop · orbit login [--force] · orbit logout · orbit whoami

• --yes 인터뷰 질문에 기본값으로 답합니다(AI 에이전트가 대신 실행할 때 유용).
• --no-interview 결정적 감지기 결과만으로 올립니다(모델 호출 없음).
• --provider host:<name> 웹 설정 → 호스트에서 등록한 BYO Docker 호스트(orbit-hostd)에 올립니다.
• --agent 샌드박스 안 코딩 에이전트. 기본 Claude(Agent SDK); ACP 에이전트(Gemini CLI, Codex)는 첫 사용 때 샌드박스에 설치됩니다.

환경변수

ORBIT_API_URL(컨트롤 플레인, 기본 https://orbit-shuttle.lightsoft.dev) · ORBIT_TOKEN(세션 토큰, CI 용) · ORBIT_NO_BROWSER=1(로그인 URL 만 출력) · ORBIT_CONFIG_DIR(자격증명 저장 위치, 기본 ~/.config/orbit-shuttle)

지원 프로젝트

Node 우선(Vite·Next·Nuxt·SvelteKit·Remix·Astro·Hono·Express…). dev 스크립트가 없는 정적 사이트는 index.html 이 있는 폴더(루트 또는 site/·public/ 등)를 npx serve 로 서빙합니다. wrangler.* 가 있으면 Cloudflare 백엔드(D1/KV/R2/DO)를 샌드박스 안 wrangler dev 로 함께 시뮬레이션합니다(워커 전용이면 그대로, 프런트가 있으면 사이드카 :8788).