CLI 개요

팀 전용 mellowz 명령으로 할 수 있는 일입니다.

현재 CLI는

mellowz 명령은 캐릭터챗 문서를 다루는 팀 전용 도구입니다. 팀 구성원이 터미널에서 문서를 만들고, 읽고, 수정 연산을 모의 실행해 보고, 제안하고, 여러 캐릭터를 일괄 제출하는 데 씁니다. 서버의 캐릭터챗 MCP를 감싼 얇은 클라이언트라서 서버에 없는 일은 하지 않습니다.
참고
이미지·영상 생성, 작업 조회, 에셋 업로드 명령은 CLI에 없습니다. 이 일은 MCP 연결이나 공개 REST로 합니다.
지금 할 수 있는 일은 다음과 같습니다.
  • 캐릭터 문서 만들기, 목록 보기, 섹션 읽기
  • 수정 연산을 서버 사본에 시험 적용(모의 실행)하고, 제안 올리기
  • 외부 플랫폼 덤프를 가져오기 전에 정규화 결과 미리 보기
  • 캐릭터 요약을 일괄(배치)로 제출하고 상태 보기
  • 환경 점검(doctor)

실행 방법

CLI는 배포 패키지가 없습니다. 저장소를 내려받은 환경에서 실행합니다. Node 22 이상이 필요합니다. 자세한 순서는 설치에 있습니다.
저장소에서 실행 — bash
pnpm --filter @mellowz-studio/contracts build
pnpm --filter @mellowz-studio/cli start -- doctor
명령을 쓰기 전에 인증을 먼저 설정하세요.

기본 규칙

  • 쓰기나 체리를 쓰는 명령은 기본이 모의 실행입니다. --execute를 붙여야 실제로 적용됩니다.
  • --json을 붙이면 표준 출력에 JSON 문서 하나만 나옵니다.
  • 종료 코드는 0부터 6까지 고정입니다. 설정에 표가 있습니다.
  • 토큰은 인자로 받지 않습니다.

관련