# PhoneWork

Feishu bot integration with Claude Code CLI.

## Architecture

- **Agent CLI**: Claude Code (print mode)
- **Chat Server**: FastAPI
- **Client**: Feishu bot API (long-connection)

## Setup

### 1. Feishu App
Create app at https://open.feishu.cn:
- Enable **Bot** capability
- Enable **long-connection event subscription** (no public URL needed)
- Get `FEISHU_APP_ID` and `FEISHU_APP_SECRET`

### 2. LLM Endpoint
Configure OpenAI-compatible endpoint:
- `OPENAI_BASE_URL`
- `OPENAI_API_KEY`
- `OPENAI_MODEL`

### 3. Claude Code CLI
- Install and authenticate `claude` command
- Ensure available in PATH

### 4. Configuration
```bash
cp keyring.example.yaml keyring.yaml
# Edit keyring.yaml with your credentials
```

### 5. Run
```bash
pip install -r requirements.txt
python main.py
```

## Requirements

| Item | Notes |
|---|---|
| Python 3.11+ | Required |
| Feishu App | Bot + long-connection enabled |
| OpenAI-compatible LLM | API endpoint and key |
| Claude Code CLI | Installed + authenticated |