# Claude CLI Proxy — Веб-клиент для Claude Code CLI

## Назначение

Локальное приложение, которое подключает Claude Code CLI к веб-интерфейсу simple-chat. Управляет PTY-процессами (node-pty), транслирует ввод/вывод терминала через WebSocket. Фронтенд отображает терминал через xterm.js.

**Это локальное приложение.** Запускается на машине разработчика, не деплоится в k3s.

## Статус

Активная разработка. Работает в связке с simple-chat (модуль agent-proxy).

## Архитектура

```
simple-chat (frontend)          simple-chat (backend)          claude-cli-proxy (local)
   xterm.js terminal  ←─WS─→  agent-proxy gateway  ←──WS──→  PtyManager
                                    │                              │
                                    │                         node-pty processes
                                    │                           ├── claude (chat 1)
                                    │                           ├── claude --resume <id> (chat 2)
                                    │                           └── ...
                                    │
                               REST API + DB (agent_devices, chats)
```

Подробности: [ARCHITECTURE.md](ARCHITECTURE.md) | Требования: [REQUIREMENTS.md](REQUIREMENTS.md)

## Технологический стек

| Компонент | Технология |
|-----------|-----------|
| Runtime | Node.js + TypeScript |
| WebSocket | ws |
| PTY | node-pty |
| Frontend terminal | xterm.js (в simple-chat) |
| Запуск | `npm start` → `tsx src/main.ts` |
| Общие конфиги | @vigdorov/eslint-config (node), @vigdorov/prettier-config, @vigdorov/typescript-config (node) |

## Структура

```
src/
├── main.ts                 # Точка входа, класс ClaudeCliProxy
├── config.ts               # Загрузка .env (PROXY_TOKEN, SERVER_URL)
├── connection/
│   ├── ws-client.ts        # WebSocket-клиент с переподключением
│   └── protocol.ts         # Типы WS-сообщений, бинарный протокол (общие с бэкендом)
└── pty/
    └── manager.ts          # Создание/удаление/resize PTY-процессов через node-pty
```

## Конфигурация (.env)

| Переменная | Описание |
|-----------|----------|
| `PROXY_TOKEN` | Токен авторизации (из настроек simple-chat) |
| `SERVER_URL` | WebSocket URL бэкенда (`ws://localhost:3000/ws/agent-proxy` или `wss://ai-chat.vigdorov.ru/ws/agent-proxy`) |

## Запуск

```bash
npm install
npm start
```

## Dev-порт: нет (только исходящие соединения, подключается к серверу)

## Связь с simple-chat

- Бэкенд: модуль `agent-proxy` (WebSocket gateway, REST API, бинарный протокол PTY ввода/вывода)
- Фронтенд: маршрут `/agent` с терминалом xterm.js, управление чатами/сессиями
- БД: таблица `agent_devices` + agent-поля в таблице `chats`