SleepCode

AI codes while you sleep — Claude AI 야간 자동화 세팅 CLI

잠자는 동안 AI가 코드를 작성하고, 빌드하고, 테스트하고, 커밋합니다.

설치

npm install -g sleepcode

또는 npx로 바로 실행:

npx sleepcode

빠른 시작

1. 프로젝트 루트에서 실행

cd my-project
npx sleepcode

인터랙티브 모드로 프로젝트 타입, 이름, AI 역할 등을 설정합니다.

2. 참고 자료 추가

.sleepcode/docs/에 기획서, 피그마 스크린샷 등 참고 자료를 넣습니다.

3. 태스크 작성

방법 A: 자동 생성 (추천)

npx sleepcode generate

참고 자료(docs/, Figma, Notion)와 프로젝트 구조를 분석해서 tasks.md를 자동 생성합니다. 이미 구현된 기능은 제외됩니다.

방법 B: 직접 작성

.sleepcode/tasks.md 에 AI가 수행할 작업을 작성합니다:

# 작업 목록

- [ ] 로그인 화면 구현
- [ ] 회원가입 API 연동
- [ ] 홈 화면 UI 개선

4. 실행

# 1회 실행
npx sleepcode run

# 무한 루프 (잠자기 전)
npx sleepcode run --loop

OS에 맞는 스크립트를 자동으로 선택합니다 (macOS/Linux: .sh, Windows: .ps1).

5. 아침에 확인

git log --oneline --since="12 hours ago"

지원 프로젝트 타입

CLI 명령어

CLI 옵션

인터랙티브 모드 외에 CLI 인자로도 사용 가능합니다:

npx sleepcode --type react-native --name my-app --role "쇼핑몰 앱 개발"

생성되는 파일

.sleepcode/
  rules.md               # ✏️ AI 역할 + 작업 규칙 (수정하세요)
  tasks.md               # ✏️ 작업 목록 (수정하세요)
  docs/                  # ✏️ 참고 자료 (피그마 스크린샷, 기획서 등)
  scripts/               # ⚙️ 시스템 (수정하지 마세요)
    base_rules.md        #    공통 작업 규칙
    ai_worker.sh/.ps1    #    1회 실행 스크립트 (OS별)
    run_forever.sh/.ps1  #    무한 루프 스크립트 (OS별)
    log_filter.py        #    실시간 로그 필터
  logs/                  # 실행 로그 (자동 생성)
  README.md              # 사용 가이드

.claude/
  settings.local.json    # Claude 권한 설정

작동 원리

rules.md + tasks.md → 프롬프트 조합 → claude -p (비대화형) → 코드 작성 → git commit → 반복

1. rules.md(AI 역할/규칙)와 tasks.md(작업 목록)를 합쳐서 프롬프트로 전달
2. Claude가 태스크를 하나씩 수행 (코드 작성 → 빌드/테스트 → 오류 수정)
3. 태스크 완료 시 [x] 체크 + git commit
4. 모든 태스크 완료되면 자동 종료 (또는 대기 후 반복)

실시간 로그

stream-json 출력을 log_filter.py가 파싱하여 핵심 메시지만 표시합니다:

[TEXT] 로그인 화면을 구현하겠습니다...
[TOOL] Edit: src/screens/LoginScreen.tsx
[TOOL] Bash: npx tsc --noEmit
[TEXT] 타입 체크 통과, 커밋합니다.
[TOOL] Bash: git commit -m "feat: 로그인 화면 구현"
[DONE] 완료
[COST] input: 50,000 / output: 12,000

tmux 관리

사전 준비 (Prerequisites)

npx sleepcode 실행 시 자동으로 필수 도구를 체크합니다. 누락된 도구가 있으면 설치 방법을 안내하며, Claude CLI는 자동 설치를 제안합니다.

필수

선택 (macOS/Linux만)

자동 체크 예시

사전 준비 확인 중...
  ✓ git (2.43.0)
  ✓ python3 (3.12.0)
  ✗ claude — 설치 필요
  - tmux — 미설치 (선택사항)

? claude CLI를 설치할까요? (npm install -g @anthropic-ai/claude-code) [Y/n]: y
  ✓ claude CLI 설치 완료

Claude CLI 권한 설정

AI 워커는 비대화형(-p) 모드에서 --dangerously-skip-permissions 플래그를 사용합니다. 최초 1회 동의가 필요합니다:

claude --dangerously-skip-permissions
# 동의 프롬프트 수락 후 Ctrl+C

Windows 지원

Windows에서는 .sh 대신 PowerShell 스크립트(.ps1)가 자동 생성됩니다. WSL 없이 바로 사용 가능합니다.

커스터마이징

• AI 역할/규칙 변경: .sleepcode/rules.md 수정
• 작업 목록 변경: .sleepcode/tasks.md 수정
• 참고 자료 추가: .sleepcode/docs/에 파일 추가 (스크린샷, 기획서 등)
• 반복 간격 변경: .sleepcode/scripts/run_forever.sh (또는 .ps1)의 sleep 값 수정
• Claude 권한 변경: .claude/settings.local.json 수정

License

MIT