87 lines
2.1 KiB
Markdown
87 lines
2.1 KiB
Markdown
# 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`가 설정된 경우 해당 채널로 알림을 보냅니다.
|