LazyEnter

소파에서 엔터나 치자.
로컬 PC의 Claude Code CLI 세션을 Slack Socket Mode로 중계해 모바일에서도 원격으로 입력/승인을 처리하는 브릿지입니다.

동작 방식

1. Slack에서 /start-claude 실행
2. 로컬에서 claude 프로세스(기본값)가 PTY로 시작됨
3. Slack 채널 메시지가 CLI 입력으로 전달됨
4. CLI 출력이 Slack으로 다시 전송됨
5. /stop-claude로 세션 종료

빠른 시작

git clone <repo-url>
cd LazyEnter
python -m venv .venv
source .venv/bin/activate
pip install -e .

.env 파일을 생성하고 값을 채우세요:

cp .env.example .env

필수 환경 변수:

• SLACK_BOT_TOKEN
• SLACK_APP_TOKEN
• SLACK_ALLOWED_USER_ID
• SLACK_ALLOWED_CHANNEL_ID

선택 환경 변수:

• DEFAULT_SHELL (기본: claude)
• PTY_READ_TIMEOUT (기본: 5)
• OUTPUT_BUFFER_INTERVAL (기본: 2.0)
• MAX_MESSAGE_LENGTH (기본: 3000)

Slack 앱 설정

• Socket Mode 활성화
• Bot Token Scopes에 chat:write, commands 추가
• Slash Commands 생성:
  • /start-claude
  • /stop-claude
• 앱을 워크스페이스에 설치 후 토큰을 .env에 반영

실행

lazy-enter
# 또는
python -m lazy_enter

실행 후 Slack의 허용된 채널에서:

• /start-claude: 세션 시작
• 일반 메시지 전송: Claude CLI로 입력 전달
• /stop-claude: 세션 종료

테스트 및 품질 점검

pytest
ruff check src/ tests/
ruff format src/ tests/
mypy src/

hooks 알림 사용 (선택)

hooks.py는 JSON 이벤트를 받아 Slack 알림 문구로 변환합니다.

echo '{"type":"prompt","tool":"Bash"}' | python -m lazy_enter.hooks

SLACK_ALLOWED_CHANNEL_ID가 설정된 경우 해당 채널로 알림을 보냅니다.