sbx env plan

sbx env plan

sbx env plan은 환경이 샌드박스 밖에서 무엇을 바꿀지 보여주는 명령이에요. 적용 없이 플랜만 확인하고 싶을 때 사용해요.

출처: 문서

본문

실험적 — 이 명령은 실험적이에요.

s bx env plan은 PATH(기본: 현재 디렉터리)에서 환경 파일을 읽고, 적용할 때 설정할 모든 것을 출력해요. 즉 실행할 호스트 명령, 프로비저닝할 자격 증명과 바인딩, 등록할 MCP 서버, 만들 디렉터리, 게시할 포트, 샌드박스 자체와 그 실행 변수까지에요.

플랜은 이 머신에서 이 환경이 마지막으로 적용한 것, 아무것도 적용되지 않았을 때 승인된 것, 현재 있는 것과 비교돼서, 두 번째 실행은 움직인 것만 보여줘요. 아무것도 적용·승인·기록되지 않아요. 실제 하려면 sbx env create 또는 sbx env run을 사용해요.

PATH 여러 개를 넘기면 순서대로 deep-merge돼요.

sbx env plan [PATH...] [flags]

지원하는 옵션은 다음과 같아요.

옵션 기본값 설명
--clone sbxenv.yaml의 workspace.clone을 재정의해요 (sbx create --clone 참고).
--env-arg 실험적 — 환경 파일이 선언한 인자 값이에요, name=value (반복 가능).
--env-args-file 실험적 — 환경 인자 파일이에요 (반복 가능); --env-arg가 우선.
--kit-arg 실험적 — kit가 선언한 인자 값이에요 (반복 가능).
--kit-args-file 실험적 — kit 인자 파일이에요 (반복 가능); --kit-arg가 우선.
--name 샌드박스 이름이에요 — sbxenv.yaml의 name:을 재정의해요.
--skip-host-commands 환경이 선언한 호스트 라이프사이클 명령 없이 플랜을 봐요.

더 알아보기