# LazyEnter

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

## 동작 방식

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

## 빠른 시작

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

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

```bash
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`)
- `RECONNECT_DELAY_SECONDS` (기본: `5.0`, Socket Mode 재연결 대기 시간)
- `OUTPUT_IDLE_REPORT_SECONDS` (기본: `120`, 출력 정지 보고 임계값)
- `INPUT_IDLE_REPORT_SECONDS` (기본: `300`, 입력 정지 보고 임계값)

`SLACK_ALLOWED_USER_ID`, `SLACK_ALLOWED_CHANNEL_ID`가 비어 있으면 실행이 중단됩니다.

## Slack 앱 설정

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

## 실행

```bash
lazy-enter
# 또는
python -m lazy_enter
```

실행 후 Slack의 허용된 채널에서:
- `/start-claude`: 세션 시작
- 일반 메시지 전송: Claude CLI로 입력 전달
- `/stop-claude`: 세션 종료

## 테스트 및 품질 점검

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

## hooks 알림 사용 (선택)

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

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

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