status, check, env & logs

안 될 때 상태, 개발 도구, 환경 변수, 로그를 점검하는 명령입니다.

안 될 때는 먼저 status를 실행하세요. 어디가 문제인지 한눈에 보입니다.

status

세팅 여부, DB 컨테이너, 마이그레이션이 최신인지, 서버 포트의 소유자와 응답을 보여 줍니다.

bash

npx @snackcup/meerkit status

출력 예

✔ 세팅: 끝남 (.env, 백엔드·프론트엔드 라이브러리)
✔ DB: 실행 중 (healthy)
✔ 마이그레이션: 최신
✔ 백엔드 (8000): 켜져 있음 → 응답 200
✔ 프론트엔드 (3000): 켜져 있음 → 응답 200

옵션	설명
`--dir <폴더>`	다른 폴더의 프로젝트를 대상으로 합니다

개발 도구를 점검하고, 없으면 설치 링크를 보여 줍니다. Node.js 20 이상, npm, uv, Docker, Docker Compose, Docker Desktop 실행 여부와 디스크 여유 공간(2GB 이상)을 확인합니다.

bash

npx @snackcup/meerkit check

Docker Desktop이 켜져 있어도 멈췄다면 “응답이 없음”으로 구분해 알려 줍니다. 디스크 공간을 확보하고 Docker Desktop을 재시작하세요.

backend/.env에서 예시 값 그대로인 비밀키, 로컬 전용 설정 등을 찾습니다. 값은 출력하지 않습니다.

bash

npx @snackcup/meerkit env check
npx @snackcup/meerkit env check --prod   # 배포 전 확인

옵션	설명
`--prod`	운영 배포 기준으로 점검합니다. 위험한 값은 오류로 보고, 문제가 있으면 종료 코드 1을 돌려줍니다

프로젝트 루트의 meerkit-setup.log 마지막 부분을 보여 줍니다. 세팅이 중간에 실패했을 때 원인을 찾는 데 씁니다.

bash

npx @snackcup/meerkit logs
npx @snackcup/meerkit logs -n 100
npx @snackcup/meerkit logs --path

옵션	설명
`-n <줄수>`	보여 줄 줄 수 (기본 50)
`--path`	로그 파일 경로만 출력합니다

안 될 때 상태, 개발 도구, 환경 변수, 로그를 점검하는 명령입니다.

안 될 때는 먼저 status를 실행하세요. 어디가 문제인지 한눈에 보입니다.

세팅 여부, DB 컨테이너, 마이그레이션이 최신인지, 서버 포트의 소유자와 응답을 보여 줍니다.

bash

npx @snackcup/meerkit status

출력 예

✔ 세팅: 끝남 (.env, 백엔드·프론트엔드 라이브러리)
✔ DB: 실행 중 (healthy)
✔ 마이그레이션: 최신
✔ 백엔드 (8000): 켜져 있음 → 응답 200
✔ 프론트엔드 (3000): 켜져 있음 → 응답 200

옵션	설명
`--dir <폴더>`	다른 폴더의 프로젝트를 대상으로 합니다

bash

npx @snackcup/meerkit check

Docker Desktop이 켜져 있어도 멈췄다면 “응답이 없음”으로 구분해 알려 줍니다. 디스크 공간을 확보하고 Docker Desktop을 재시작하세요.

backend/.env에서 예시 값 그대로인 비밀키, 로컬 전용 설정 등을 찾습니다. 값은 출력하지 않습니다.

bash

npx @snackcup/meerkit env check
npx @snackcup/meerkit env check --prod   # 배포 전 확인

옵션	설명
`--prod`	운영 배포 기준으로 점검합니다. 위험한 값은 오류로 보고, 문제가 있으면 종료 코드 1을 돌려줍니다

프로젝트 루트의 meerkit-setup.log 마지막 부분을 보여 줍니다. 세팅이 중간에 실패했을 때 원인을 찾는 데 씁니다.

bash

npx @snackcup/meerkit logs
npx @snackcup/meerkit logs -n 100
npx @snackcup/meerkit logs --path

옵션	설명
`-n <줄수>`	보여 줄 줄 수 (기본 50)
`--path`	로그 파일 경로만 출력합니다