Loom CLI

터미널에서 워크스페이스를 열거나, 프롬프트를 헤드리스로 실행하기

Loom CLI로 할 수 있는 일

loom 명령 하나로 두 가지를 할 수 있습니다.

  1. 앱 열기: 현재 폴더/지정 폴더를 Loom 워크스페이스로 열기
  2. 헤드리스 실행: GUI 없이 프롬프트를 실행하고 결과를 터미널로 받기

헤드리스 실행 결과는 세션에도 저장되어 앱에서 이어서 확인할 수 있습니다. 셸 스크립트, CI/CD 파이프라인, cron 등과 결합하면 반복 작업을 자동화할 수 있습니다.

설치

Loom 앱에서 설치합니다.

  1. Settings → Account → Loom CLI 이동
  2. Install 클릭
  3. 새 터미널 창을 열고 loom --help 확인

빠른 사용 예시

# 현재 폴더를 워크스페이스로 열기
loom

# 특정 폴더를 워크스페이스로 열기
loom /path/to/workspace

# 헤드리스 실행
loom exec "이 폴더 TODO 정리해줘"

# 모델/출력 포맷 지정
loom --model gpt-5 --json "최근 변경사항 요약해줘"

옵션

실행 환경

  • -C, --cd <dir>: 워크스페이스 루트 지정 (기본값: 현재 디렉터리)
  • -m, --model <model>: 모델 지정 (기본값: 워크스페이스 설정)
  • --reasoning-effort <level> (--effort): 리즈닝 강도 힌트 (기본값: 모델 기본값)

출력

  • --output-format text|json|stream-json: 출력 형식 (기본값: text)
    • text — 최종 답변 텍스트만 출력
    • json — 실행 결과를 1개 JSON 객체로 출력
    • stream-json — 이벤트 스트림(JSONL) 출력
  • --json: --output-format stream-json의 단축 표현

세션

  • -c, --continue: 해당 워크스페이스의 최신 세션 이어서 실행 (기본값: 새 세션)
  • --session-id <id> / -r, --resume <id>: 특정 세션 이어서 실행

동작 규칙 (중요)

  • loom, loom [path]는 기본적으로 앱 열기 모드입니다.
  • loom exec ... 또는 헤드리스 옵션(--model, --json 등)을 쓰면 헤드리스 모드로 동작합니다.
  • bare positional 입력은 경로로 해석됩니다.
    • 예: loom "hello" 는 프롬프트가 아니라 경로로 해석됩니다.
  • 헤드리스 옵션이 있으면 positional은 프롬프트로 해석됩니다.
    • 예: loom --model gpt-5 "hello" 는 헤드리스 실행입니다.

문제 해결

  • loom doctor: CLI와 앱 바이너리 경로 확인
  • loom --help: 전체 옵션 확인