purplemux 0.1.2

package/README.pt-BR.md

@@ -0,0 +1,224 @@
+# purplemux
+
+**Claude Code, várias tarefas ao mesmo tempo. Mais rápido.**
+
+Todas as sessões em uma tela só. Sem quebras, até no celular.
+
+<a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.zh-TW.md">繁體中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.ru.md">Русский</a> | Português (Brasil) | <a href="README.tr.md">Türkçe</a>
+
+![purplemux](docs/images/screenshot.png)
+
+![purplemux mobile](docs/images/screenshot-mobile.png)
+
+## Instalação
+
+```bash
+npx purplemux
+```
+
+Abra [http://localhost:8022](http://localhost:8022) no navegador. Pronto.
+
+> Requer Node.js 20+ e tmux. macOS ou Linux.
+
+## Por que purplemux
+
+- **Painel multissessão** — Veja o status «trabalhando / aguardando entrada» de todas as sessões do Claude Code de relance
+- **Monitor de rate limit** — Saldo de 5 horas / 7 dias com contagem regressiva até o reset
+- **Notificações push** — Alertas no desktop e no mobile quando uma tarefa termina ou precisa de entrada
+- **Mobile e multi-dispositivo** — Acesse a mesma sessão a partir do celular, tablet ou outro desktop
+- **Visualização da sessão ao vivo** — Sem mais rolar a saída do CLI: o progresso é apresentado como uma linha do tempo
+
+E ainda
+
+- **Sessões sem quebras** — Baseado em tmux. Feche o navegador e tudo continua no lugar. Ao reconectar, suas abas, painéis e diretórios estão exatamente onde você deixou
+- **Self-hosted e open source** — Código e dados de sessão nunca saem da sua máquina. Sem servidores externos
+- **Acesso remoto criptografado** — HTTPS de qualquer lugar via Tailscale
+
+## Diferenças para o Remote Control oficial
+
+> O Remote Control oficial foca no controle remoto de uma única sessão. Use o purplemux quando precisar de gestão multissessão, notificações push e persistência de sessão.
+
+## Recursos
+
+### Terminal
+
+- **Divisão de painéis** — Divisão horizontal / vertical livre, com redimensionamento por arrasto
+- **Gerenciamento de abas** — Múltiplas abas, reordenação por arrasto, títulos automáticos baseados no nome do processo
+- **Atalhos de teclado** — Divisão, troca de abas, movimento de foco
+- **Temas do terminal** — Modo escuro / claro e vários esquemas de cores
+- **Workspaces** — Salve e restaure layouts de painéis, abas e diretórios de trabalho por workspace
+- **Visualizador de Git Diff** — Inspecione o git diff direto em um painel do terminal. Alternância Side-by-side / Line-by-line com destaque de sintaxe
+- **Painel de navegador web** — Navegador embutido ao lado do terminal para conferir o resultado de desenvolvimento (Electron)
+
+### Integração com Claude Code
+
+- **Status em tempo real** — Indicadores de trabalhando / aguardando entrada e troca entre sessões
+- **Visualização da sessão ao vivo** — Mensagens, chamadas de ferramentas, tarefas, solicitações de permissão e blocos thinking
+- **Resume em um clique** — Retome sessões pausadas direto do navegador
+- **Resume automático** — Restauração automática de sessões anteriores do Claude ao iniciar o servidor
+- **Prompts rápidos** — Cadastre prompts frequentes e envie com um clique
+- **Histórico de mensagens** — Reutilize mensagens anteriores
+- **Estatísticas de uso** — Tokens (input / output / cache read / cache write), custo, análise por projeto e relatórios de IA diários
+- **Rate limit** — Saldo de 5 horas / 7 dias com contagem regressiva de reset
+
+### Mobile e acessibilidade
+
+- **UI responsiva** — Terminal e linha do tempo no celular e tablet
+- **PWA** — Adicione à tela inicial para uma experiência próxima de um app nativo
+- **Web Push** — Receba notificações mesmo após fechar a aba
+- **Sincronização multi-dispositivo** — Alterações no workspace refletem em tempo real
+- **Tailscale** — Acesso HTTPS externo via túnel criptografado WireGuard
+- **Autenticação por senha** — Hashing com scrypt, seguro mesmo quando exposto externamente
+- **Multilíngue** — 11 idiomas, incluindo 한국어, English, 日本語, 中文
+
+### Agentes de IA (Beta)
+
+Crie agentes de IA independentes, atribua a eles papéis e personalidades (souls) e execute tarefas em paralelo com várias abas. Cada agente tem seu próprio chat, memória e workspace.
+
+## Plataformas suportadas
+
+| Plataforma | Status | Observações |
+|---|---|---|
+| macOS (Apple Silicon / Intel) | ✅ | App Electron incluído |
+| Linux | ✅ | Sem Electron |
+| Windows | ❌ | Sem suporte |
+
+## Detalhes de instalação
+
+### Requisitos
+
+- macOS 13+ ou Linux
+- [Node.js](https://nodejs.org/) 20+
+- [tmux](https://github.com/tmux/tmux)
+
+### npx (mais rápido)
+
+```bash
+npx purplemux
+```
+
+### Instalação global
+
+```bash
+npm install -g purplemux
+purplemux
+```
+
+### A partir do código-fonte
+
+```bash
+git clone https://github.com/subicura/purplemux.git
+cd purplemux
+pnpm install
+pnpm start
+```
+
+Modo de desenvolvimento:
+
+```bash
+pnpm dev
+```
+
+#### Nível de log
+
+Ajuste o nível geral com `LOG_LEVEL` (padrão `info`).
+
+```bash
+LOG_LEVEL=debug pnpm dev
+```
+
+Para ativar apenas módulos específicos, liste pares `modulo=nivel` separados por vírgula em `LOG_LEVELS`. Níveis disponíveis: `trace` / `debug` / `info` / `warn` / `error` / `fatal`.
+
+```bash
+# Rastreia somente o comportamento dos hooks do Claude Code em debug
+LOG_LEVELS=hooks=debug pnpm dev
+
+# Vários módulos ao mesmo tempo
+LOG_LEVELS=hooks=debug,status=warn pnpm dev
+```
+
+Módulos não listados em `LOG_LEVELS` usam o valor de `LOG_LEVEL`.
+
+## Acesso externo (Tailscale Serve)
+
+```bash
+tailscale serve --bg 8022
+```
+
+Acesse em `https://<machine>.<tailnet>.ts.net`. Para desativar:
+
+```bash
+tailscale serve --bg off 8022
+```
+
+## Segurança
+
+### Senha
+
+Defina uma senha no primeiro acesso. Ela é armazenada com hash scrypt em `~/.purplemux/config.json`.
+
+Para redefinir, apague `~/.purplemux/config.json` e reinicie — a tela de onboarding aparece novamente.
+
+### HTTPS
+
+Por padrão, o protocolo é HTTP. Sempre use HTTPS ao expor externamente:
+
+- **Tailscale Serve** — Criptografia WireGuard com certificados automáticos
+- **Nginx / Caddy** — Deve encaminhar os cabeçalhos de upgrade de WebSocket (`Upgrade`, `Connection`)
+
+### Diretório de dados (`~/.purplemux/`)
+
+| Arquivo | Descrição |
+|---|---|
+| `config.json` | Credenciais (hash) e configurações do app |
+| `workspaces.json` | Layouts de workspaces, abas e diretórios |
+| `vapid-keys.json` | Chaves VAPID do Web Push (geradas automaticamente) |
+| `push-subscriptions.json` | Dados de assinaturas push |
+| `hooks/` | Hooks definidos pelo usuário |
+
+## Arquitetura
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Browser                                                    │
+│  ┌───────────┐ ┌───────────┐ ┌──────────┐ ┌─────────────┐   │
+│  │  xterm.js │ │ Timeline  │ │ Status   │ │ Multi-device│   │
+│  │  Terminal │ │           │ │          │ │ Sync        │   │
+│  └─────┬─────┘ └─────┬─────┘ └────┬─────┘ └──────┬──────┘   │
+└────────┼─────────────┼────────────┼──────────────┼──────────┘
+         │ws           │ws          │ws            │ws
+         │/terminal    │/timeline   │/status       │/sync
+         ▼             ▼            ▼              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  Node.js Server (:8022)                                     │
+│  ┌──────────┐  ┌───────────────┐  ┌─────────────────────┐   │
+│  │ node-pty │  │ JSONL Watcher │  │ Status Manager      │   │
+│  │ PTY↔WS   │  │ File watch →  │  │ Process tree +      │   │
+│  │ Binary   │  │ Parse → Send  │  │ JSONL tail analysis │   │
+│  └────┬─────┘  └───────┬───────┘  └──────────┬──────────┘   │
+└───────┼────────────────┼─────────────────────┼──────────────┘
+        ▼                ▼                     ▼
+┌─────────────────────────────────────────────────────────────┐
+│  System                                                     │
+│  tmux (purple socket)         Claude Code                   │
+│  ┌────────┐ ┌────────┐       ┌────────────────────────────┐ │
+│  │Session1│ │Session2│  ...  │ ~/.claude/sessions/        │ │
+│  │ (shell)│ │ (shell)│       │ ~/.claude/projects/        │ │
+│  └────────┘ └────────┘       │   └─ {project}/{sid}.jsonl │ │
+│                              └────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**I/O do terminal** — xterm.js conecta-se ao node-pty via WebSocket e o node-pty se acopla às sessões do tmux. Um protocolo binário trata stdin/stdout/resize com controle de backpressure.
+
+**Detecção de status** — Os hooks de eventos do Claude Code (`SessionStart`, `Stop`, `Notification`) entregam atualizações imediatas via HTTP POST. A cada 5–15 s a árvore de processos é inspecionada e os últimos 8 KB dos arquivos JSONL são analisados.
+
+**Timeline** — Observa os logs de sessão JSONL em `~/.claude/projects/`, faz o parse das novas linhas a cada mudança e envia entradas estruturadas para o navegador.
+
+**Isolamento do tmux** — Usa um socket `purple` dedicado, completamente separado do seu tmux existente. Sem tecla prefixo nem barra de status.
+
+**Recuperação automática** — Ao iniciar o servidor, sessões anteriores do Claude são restauradas via `claude --resume {sessionId}`.
+
+## License
+
+[MIT](LICENSE)

package/README.ru.md

@@ -0,0 +1,224 @@
+# purplemux
+
+**Claude Code, много задач одновременно. Быстрее.**
+
+Все сессии на одном экране. Без обрывов — даже с телефона.
+
+<a href="README.md">English</a> | <a href="README.ja.md">日本語</a> | <a href="README.zh-CN.md">简体中文</a> | <a href="README.zh-TW.md">繁體中文</a> | <a href="README.ko.md">한국어</a> | <a href="README.de.md">Deutsch</a> | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | Русский | <a href="README.pt-BR.md">Português (Brasil)</a> | <a href="README.tr.md">Türkçe</a>
+
+![purplemux](docs/images/screenshot.png)
+
+![purplemux mobile](docs/images/screenshot-mobile.png)
+
+## Установка
+
+```bash
+npx purplemux
+```
+
+Откройте [http://localhost:8022](http://localhost:8022) в браузере. Готово.
+
+> Требуется Node.js 20+ и tmux. macOS или Linux.
+
+## Почему purplemux
+
+- **Дашборд нескольких сессий** — одним взглядом видите статус «работает / ждёт ввода» по каждой сессии Claude Code
+- **Мониторинг rate limit** — остаток за 5 часов / 7 дней и обратный отсчёт до сброса
+- **Push-уведомления** — оповещения на десктопе и мобильном, когда задача завершена или нужен ввод
+- **Мобильность и мульти-устройства** — доступ к одной и той же сессии с телефона, планшета или другого рабочего места
+- **Live-вид сессии** — не нужно прокручивать вывод CLI: прогресс показывается в виде таймлайна
+
+А также
+
+- **Непрерывные сессии** — на базе tmux. Закрыли браузер — всё осталось на месте. При повторном подключении вкладки, панели и каталоги в точности там, где вы их оставили
+- **Self-hosted и open source** — код и данные сессий никогда не покидают вашу машину. Никаких внешних серверов
+- **Шифрованный удалённый доступ** — HTTPS откуда угодно через Tailscale
+
+## Отличия от официального Remote Control
+
+> Официальный Remote Control сфокусирован на удалённом управлении одной сессией. purplemux нужен, когда требуется управление множеством сессий, push-уведомления и устойчивые сессии.
+
+## Возможности
+
+### Терминал
+
+- **Разделение панелей** — свободное горизонтальное / вертикальное разделение, изменение размера перетаскиванием
+- **Управление вкладками** — много вкладок, перестановка перетаскиванием, автоматические заголовки на основе имени процесса
+- **Горячие клавиши** — разделение, переключение вкладок, перемещение фокуса
+- **Темы терминала** — тёмный / светлый режим, несколько цветовых тем
+- **Рабочие пространства** — сохранение и восстановление раскладки панелей, вкладок и рабочих каталогов в пределах рабочего пространства
+- **Просмотр git diff** — проверка git diff прямо в панели терминала. Переключение Side-by-side / Line-by-line, подсветка синтаксиса
+- **Панель веб-браузера** — встроенный браузер рядом с терминалом для проверки результата разработки (Electron)
+
+### Интеграция с Claude Code
+
+- **Статус в реальном времени** — индикаторы «работает / ждёт ввода», переключение между сессиями
+- **Live-вид сессии** — сообщения, вызовы инструментов, задачи, запросы разрешений, блоки thinking
+- **Resume в один клик** — возобновляйте приостановленную сессию прямо из браузера
+- **Автоматический resume** — при старте сервера восстанавливаются предыдущие сессии Claude
+- **Быстрые промпты** — сохраняйте часто используемые промпты и отправляйте их в один клик
+- **История сообщений** — повторно используйте прошлые сообщения
+- **Статистика использования** — токены (input / output / cache read / cache write), стоимость, разбивка по проектам, ежедневные AI-отчёты
+- **Rate limit** — остаток за 5 часов / 7 дней, обратный отсчёт до сброса
+
+### Мобильность и доступность
+
+- **Адаптивный UI** — терминал и таймлайн на телефоне и планшете
+- **PWA** — добавление на главный экран, ощущение нативного приложения
+- **Web Push** — уведомления приходят даже после закрытия вкладки
+- **Синхронизация между устройствами** — изменения в рабочем пространстве отражаются в реальном времени
+- **Tailscale** — HTTPS-доступ извне через туннель с шифрованием WireGuard
+- **Аутентификация по паролю** — scrypt-хеширование, безопасно даже при внешнем доступе
+- **Многоязычность** — 11 языков, включая 한국어, English, 日本語, 中文
+
+### AI-агенты (Beta)
+
+Создавайте независимых AI-агентов, задавайте им роли и характер (soul) и запускайте задачи параллельно на нескольких вкладках. У каждого агента свой чат, память и рабочее пространство.
+
+## Поддерживаемые платформы
+
+| Платформа | Статус | Примечания |
+|---|---|---|
+| macOS (Apple Silicon / Intel) | ✅ | Electron-приложение в комплекте |
+| Linux | ✅ | Без Electron |
+| Windows | ❌ | Не поддерживается |
+
+## Подробности установки
+
+### Требования
+
+- macOS 13+ или Linux
+- [Node.js](https://nodejs.org/) 20+
+- [tmux](https://github.com/tmux/tmux)
+
+### npx (самый быстрый способ)
+
+```bash
+npx purplemux
+```
+
+### Глобальная установка
+
+```bash
+npm install -g purplemux
+purplemux
+```
+
+### Запуск из исходников
+
+```bash
+git clone https://github.com/subicura/purplemux.git
+cd purplemux
+pnpm install
+pnpm start
+```
+
+Режим разработки:
+
+```bash
+pnpm dev
+```
+
+#### Уровень логирования
+
+Общий уровень задаётся переменной `LOG_LEVEL` (по умолчанию `info`).
+
+```bash
+LOG_LEVEL=debug pnpm dev
+```
+
+Чтобы включить отдельные модули, перечислите пары `модуль=уровень` через запятую в `LOG_LEVELS`. Доступные уровни: `trace` / `debug` / `info` / `warn` / `error` / `fatal`.
+
+```bash
+# Трассировать только хуки Claude Code на уровне debug
+LOG_LEVELS=hooks=debug pnpm dev
+
+# Несколько модулей сразу
+LOG_LEVELS=hooks=debug,status=warn pnpm dev
+```
+
+Модули, не указанные в `LOG_LEVELS`, используют значение `LOG_LEVEL`.
+
+## Внешний доступ (Tailscale Serve)
+
+```bash
+tailscale serve --bg 8022
+```
+
+Доступ по адресу `https://<machine>.<tailnet>.ts.net`. Отключение:
+
+```bash
+tailscale serve --bg off 8022
+```
+
+## Безопасность
+
+### Пароль
+
+Пароль задаётся при первом входе. Он хешируется scrypt и сохраняется в `~/.purplemux/config.json`.
+
+Чтобы сбросить, удалите `~/.purplemux/config.json` и перезапустите сервер — окно онбординга появится снова.
+
+### HTTPS
+
+По умолчанию используется HTTP. При внешнем доступе обязательно применяйте HTTPS:
+
+- **Tailscale Serve** — шифрование WireGuard и автоматические сертификаты
+- **Nginx / Caddy** — необходимо пробрасывать заголовки WebSocket upgrade (`Upgrade`, `Connection`)
+
+### Каталог данных (`~/.purplemux/`)
+
+| Файл | Описание |
+|---|---|
+| `config.json` | Данные аутентификации (хеш) и настройки приложения |
+| `workspaces.json` | Раскладки рабочих пространств, вкладки, каталоги |
+| `vapid-keys.json` | Ключи VAPID для Web Push (генерируются автоматически) |
+| `push-subscriptions.json` | Данные push-подписок |
+| `hooks/` | Пользовательские хуки |
+
+## Архитектура
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  Browser                                                    │
+│  ┌───────────┐ ┌───────────┐ ┌──────────┐ ┌─────────────┐   │
+│  │  xterm.js │ │ Timeline  │ │ Status   │ │ Multi-device│   │
+│  │  Terminal │ │           │ │          │ │ Sync        │   │
+│  └─────┬─────┘ └─────┬─────┘ └────┬─────┘ └──────┬──────┘   │
+└────────┼─────────────┼────────────┼──────────────┼──────────┘
+         │ws           │ws          │ws            │ws
+         │/terminal    │/timeline   │/status       │/sync
+         ▼             ▼            ▼              ▼
+┌─────────────────────────────────────────────────────────────┐
+│  Node.js Server (:8022)                                     │
+│  ┌──────────┐  ┌───────────────┐  ┌─────────────────────┐   │
+│  │ node-pty │  │ JSONL Watcher │  │ Status Manager      │   │
+│  │ PTY↔WS   │  │ File watch →  │  │ Process tree +      │   │
+│  │ Binary   │  │ Parse → Send  │  │ JSONL tail analysis │   │
+│  └────┬─────┘  └───────┬───────┘  └──────────┬──────────┘   │
+└───────┼────────────────┼─────────────────────┼──────────────┘
+        ▼                ▼                     ▼
+┌─────────────────────────────────────────────────────────────┐
+│  System                                                     │
+│  tmux (purple socket)         Claude Code                   │
+│  ┌────────┐ ┌────────┐       ┌────────────────────────────┐ │
+│  │Session1│ │Session2│  ...  │ ~/.claude/sessions/        │ │
+│  │ (shell)│ │ (shell)│       │ ~/.claude/projects/        │ │
+│  └────────┘ └────────┘       │   └─ {project}/{sid}.jsonl │ │
+│                              └────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**I/O терминала** — xterm.js подключается к node-pty через WebSocket, а node-pty — к сессиям tmux. Бинарный протокол обрабатывает stdin/stdout/resize с контролем backpressure.
+
+**Определение статуса** — хуки событий Claude Code (`SessionStart`, `Stop`, `Notification`) мгновенно доставляют обновления по HTTP POST. Каждые 5–15 с проверяется дерево процессов и анализируются последние 8 КБ JSONL-файла.
+
+**Таймлайн** — отслеживает JSONL-логи сессий в `~/.claude/projects/`, разбирает новые строки при изменении файла и транслирует структурированные записи в браузер.
+
+**Изоляция tmux** — используется отдельный сокет `purple`, полностью независимый от уже работающего tmux. Без prefix-клавиши и статус-бара.
+
+**Автовосстановление** — при старте сервера предыдущие сессии Claude восстанавливаются через `claude --resume {sessionId}`.
+
+## License
+
+[MIT](LICENSE)