purplemux 0.1.2

package/README.de.md

@@ -0,0 +1,224 @@
+# purplemux
+
+**Claude Code, viele Aufgaben gleichzeitig. Schneller.**
+
+Alle Sessions auf einem Bildschirm. Unterbrechungsfrei, auch auf dem Handy.
+
+<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> | Deutsch | <a href="README.es.md">Español</a> | <a href="README.fr.md">Français</a> | <a href="README.ru.md">Русский</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)
+
+## Installation
+
+```bash
+npx purplemux
+```
+
+Öffne [http://localhost:8022](http://localhost:8022) im Browser. Fertig.
+
+> Erfordert Node.js 20+ und tmux. macOS oder Linux.
+
+## Warum purplemux
+
+- **Multi-Session-Dashboard** — Behalte „arbeitet / wartet auf Eingabe"-Status aller Claude-Code-Sessions auf einen Blick im Überblick
+- **Rate-Limit-Überwachung** — Restkontingent für 5 Stunden / 7 Tage samt Reset-Countdown
+- **Push-Benachrichtigungen** — Desktop- und Mobile-Hinweise, wenn eine Aufgabe fertig ist oder Eingaben nötig sind
+- **Mobil & geräteübergreifend** — Dieselbe Session vom Handy, Tablet oder einem anderen Desktop aus erreichen
+- **Live-Session-Ansicht** — Kein Scrollen durch CLI-Ausgaben mehr. Der Fortschritt wird als Timeline aufbereitet
+
+Außerdem
+
+- **Unterbrechungsfreie Sessions** — Basiert auf tmux. Browser schließen, und alles bleibt wie es war. Beim Wiederverbinden sind Tabs, Panels und Verzeichnisse exakt dort, wo du aufgehört hast
+- **Selbst gehostet & Open Source** — Code und Session-Daten verlassen deine Maschine nie. Keine externen Server
+- **Verschlüsselter Fernzugriff** — HTTPS von überall über Tailscale
+
+## Unterschied zur offiziellen Remote Control
+
+> Die offizielle Remote Control konzentriert sich auf die Fernsteuerung einer einzelnen Session. purplemux ist das Richtige, wenn du Multi-Session-Management, Push-Benachrichtigungen und persistente Sessions brauchst.
+
+## Funktionen
+
+### Terminal
+
+- **Panel-Splits** — Horizontal / vertikal frei teilen, Größe per Drag verändern
+- **Tab-Management** — Mehrere Tabs, Reihenfolge per Drag, automatische Titel auf Basis der Prozessnamen
+- **Tastenkürzel** — Splits, Tab-Wechsel, Fokusbewegung
+- **Terminal-Themes** — Dark-/Light-Modus, mehrere Farbschemata
+- **Workspaces** — Panel-Layouts, Tabs und Arbeitsverzeichnisse pro Workspace speichern und wiederherstellen
+- **Git-Diff-Viewer** — Git-Diffs direkt im Terminal-Panel einsehen. Umschaltbar zwischen Side-by-side / Line-by-line, mit Syntax-Highlighting
+- **Webbrowser-Panel** — Eingebetteter Browser neben dem Terminal zum Prüfen der Entwicklungsausgabe (Electron)
+
+### Claude-Code-Integration
+
+- **Echtzeit-Status** — „Arbeitet / wartet auf Eingabe"-Anzeigen, Wechsel zwischen Sessions
+- **Live-Session-Ansicht** — Nachrichten, Tool-Aufrufe, Tasks, Berechtigungsanfragen, Thinking-Blöcke
+- **Ein-Klick-Resume** — Unterbrochene Sessions direkt im Browser wieder aufnehmen
+- **Auto-Resume** — Stellt beim Serverstart vorherige Claude-Sessions automatisch wieder her
+- **Schnell-Prompts** — Häufig genutzte Prompts hinterlegen und mit einem Klick senden
+- **Nachrichtenverlauf** — Frühere Nachrichten wiederverwenden
+- **Nutzungsstatistik** — Tokens (input / output / cache read / cache write), Kosten, Auswertung pro Projekt, tägliche KI-Berichte
+- **Rate-Limits** — Restkontingent 5 Stunden / 7 Tage mit Reset-Countdown
+
+### Mobil & Zugänglichkeit
+
+- **Responsive UI** — Terminal und Timeline auf Handys und Tablets
+- **PWA** — Zum Home-Bildschirm hinzufügen für ein natives App-Gefühl
+- **Web Push** — Benachrichtigungen auch dann, wenn der Tab geschlossen ist
+- **Multi-Device-Sync** — Workspace-Änderungen werden in Echtzeit übernommen
+- **Tailscale** — HTTPS-Zugriff von außen über einen WireGuard-verschlüsselten Tunnel
+- **Passwort-Authentifizierung** — scrypt-Hashing, sicher auch bei externer Exposition
+- **Mehrsprachig** — 11 Sprachen inklusive 한국어, English, 日本語, 中文
+
+### KI-Agenten (Beta)
+
+Lege eigenständige KI-Agenten an, weise ihnen Rollen und Persönlichkeiten (souls) zu und führe Aufgaben parallel über mehrere Tabs aus. Jeder Agent besitzt eigenen Chat, Speicher und Workspace.
+
+## Unterstützte Plattformen
+
+| Plattform | Status | Hinweise |
+|---|---|---|
+| macOS (Apple Silicon / Intel) | ✅ | Electron-App inklusive |
+| Linux | ✅ | Ohne Electron |
+| Windows | ❌ | Nicht unterstützt |
+
+## Installationsdetails
+
+### Voraussetzungen
+
+- macOS 13+ oder Linux
+- [Node.js](https://nodejs.org/) 20+
+- [tmux](https://github.com/tmux/tmux)
+
+### npx (am schnellsten)
+
+```bash
+npx purplemux
+```
+
+### Globale Installation
+
+```bash
+npm install -g purplemux
+purplemux
+```
+
+### Aus dem Quellcode
+
+```bash
+git clone https://github.com/subicura/purplemux.git
+cd purplemux
+pnpm install
+pnpm start
+```
+
+Entwicklungsmodus:
+
+```bash
+pnpm dev
+```
+
+#### Log-Level
+
+Das Gesamt-Level wird über `LOG_LEVEL` (Standard `info`) eingestellt.
+
+```bash
+LOG_LEVEL=debug pnpm dev
+```
+
+Um nur bestimmte Module zu aktivieren, liste `modul=level`-Paare kommagetrennt in `LOG_LEVELS` auf. Verfügbare Level: `trace` / `debug` / `info` / `warn` / `error` / `fatal`.
+
+```bash
+# Nur das Verhalten der Claude-Code-Hooks auf debug verfolgen
+LOG_LEVELS=hooks=debug pnpm dev
+
+# Mehrere Module gleichzeitig
+LOG_LEVELS=hooks=debug,status=warn pnpm dev
+```
+
+Module, die nicht in `LOG_LEVELS` stehen, verwenden den Wert von `LOG_LEVEL`.
+
+## Externer Zugriff (Tailscale Serve)
+
+```bash
+tailscale serve --bg 8022
+```
+
+Zugriff über `https://<machine>.<tailnet>.ts.net`. Deaktivieren:
+
+```bash
+tailscale serve --bg off 8022
+```
+
+## Sicherheit
+
+### Passwort
+
+Beim ersten Zugriff legst du ein Passwort fest. Es wird mit scrypt gehasht und in `~/.purplemux/config.json` gespeichert.
+
+Zum Zurücksetzen die Datei `~/.purplemux/config.json` löschen und neu starten — der Onboarding-Bildschirm erscheint wieder.
+
+### HTTPS
+
+Standard ist HTTP. Bei externer Erreichbarkeit unbedingt HTTPS verwenden:
+
+- **Tailscale Serve** — WireGuard-Verschlüsselung plus automatische Zertifikate
+- **Nginx / Caddy** — Muss die WebSocket-Upgrade-Header (`Upgrade`, `Connection`) weiterreichen
+
+### Datenverzeichnis (`~/.purplemux/`)
+
+| Datei | Beschreibung |
+|---|---|
+| `config.json` | Zugangsdaten (gehasht) und App-Einstellungen |
+| `workspaces.json` | Workspace-Layouts, Tabs, Verzeichnisse |
+| `vapid-keys.json` | Web-Push-VAPID-Schlüssel (automatisch generiert) |
+| `push-subscriptions.json` | Push-Abonnementdaten |
+| `hooks/` | Benutzerdefinierte Hooks |
+
+## Architektur
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  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 │ │
+│                              └────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**Terminal-I/O** — xterm.js verbindet sich über WebSocket mit node-pty; node-pty hängt an tmux-Sessions. Ein Binärprotokoll übernimmt stdin/stdout/resize mit Backpressure-Kontrolle.
+
+**Statuserkennung** — Claude-Code-Event-Hooks (`SessionStart`, `Stop`, `Notification`) liefern sofortige Updates per HTTP POST. Alle 5–15 s werden Prozessbäume geprüft und die letzten 8 KB der JSONL-Dateien analysiert.
+
+**Timeline** — Überwacht JSONL-Session-Logs unter `~/.claude/projects/`, parst bei Änderungen neue Zeilen und streamt strukturierte Einträge an den Browser.
+
+**tmux-Isolation** — Nutzt einen eigenen `purple`-Socket, vollständig getrennt von deinem bestehenden tmux. Kein Prefix-Key, keine Statusleiste.
+
+**Auto-Recovery** — Beim Serverstart werden vorherige Claude-Sessions via `claude --resume {sessionId}` wiederhergestellt.
+
+## License
+
+[MIT](LICENSE)

package/README.es.md

@@ -0,0 +1,224 @@
+# purplemux
+
+**Claude Code, muchas tareas a la vez. Más rápido.**
+
+Todas tus sesiones en una sola pantalla. Sin interrupciones, incluso desde el móvil.
+
+<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> | Español | <a href="README.fr.md">Français</a> | <a href="README.ru.md">Русский</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)
+
+## Instalación
+
+```bash
+npx purplemux
+```
+
+Abre [http://localhost:8022](http://localhost:8022) en tu navegador. Listo.
+
+> Requiere Node.js 20+ y tmux. macOS o Linux.
+
+## Por qué purplemux
+
+- **Panel multisesión** — Consulta de un vistazo el estado «trabajando / requiere entrada» de todas tus sesiones de Claude Code
+- **Monitor de límites** — Saldo de 5 horas / 7 días y cuenta atrás para el reinicio
+- **Notificaciones push** — Avisos de escritorio y móvil cuando una tarea termina o requiere entrada
+- **Móvil y multi-dispositivo** — Accede a la misma sesión desde el teléfono, la tablet u otro escritorio
+- **Vista en vivo de la sesión** — Deja de desplazarte por la salida de la CLI: el progreso se organiza como una línea temporal
+
+Además
+
+- **Sesiones sin interrupciones** — Basado en tmux. Cierra el navegador y todo queda intacto. Al reconectarte, tus pestañas, paneles y directorios están exactamente donde los dejaste
+- **Autoalojado y de código abierto** — El código y los datos de sesión nunca salen de tu máquina. Sin servidores externos
+- **Acceso remoto cifrado** — HTTPS desde cualquier lugar vía Tailscale
+
+## Diferencias con el Remote Control oficial
+
+> El Remote Control oficial se centra en el control remoto de una única sesión. Usa purplemux cuando necesites gestión multisesión, notificaciones push y persistencia de sesiones.
+
+## Características
+
+### Terminal
+
+- **Paneles divididos** — División horizontal / vertical libre, redimensionables con arrastrar
+- **Gestión de pestañas** — Múltiples pestañas, reordenación por arrastre, títulos automáticos basados en el nombre del proceso
+- **Atajos de teclado** — División, cambio de pestaña, movimiento de foco
+- **Temas de terminal** — Modo oscuro / claro y varios esquemas de color
+- **Workspaces** — Guarda y restaura diseños de paneles, pestañas y directorios de trabajo por workspace
+- **Visor de git diff** — Inspecciona diffs directamente en un panel del terminal. Conmuta entre Side-by-side / Line-by-line, con resaltado de sintaxis
+- **Panel de navegador web** — Navegador integrado junto al terminal para comprobar la salida de desarrollo (Electron)
+
+### Integración con Claude Code
+
+- **Estado en tiempo real** — Indicadores de trabajando / requiere entrada y cambio entre sesiones
+- **Vista en vivo de la sesión** — Mensajes, llamadas a herramientas, tareas, solicitudes de permisos y bloques de thinking
+- **Reanudación en un clic** — Retoma una sesión pausada directamente desde el navegador
+- **Reanudación automática** — Recupera sesiones previas de Claude al arrancar el servidor
+- **Prompts rápidos** — Registra prompts frecuentes y envíalos con un clic
+- **Historial de mensajes** — Reutiliza mensajes anteriores
+- **Estadísticas de uso** — Tokens (input / output / cache read / cache write), coste, desglose por proyecto e informes diarios de IA
+- **Rate limits** — Saldo de 5 horas / 7 días y cuenta atrás para el reinicio
+
+### Móvil y accesibilidad
+
+- **Interfaz responsive** — Terminal y línea temporal en móviles y tablets
+- **PWA** — Añádelo a la pantalla de inicio para sentirlo como una app nativa
+- **Web Push** — Recibe notificaciones aunque hayas cerrado la pestaña
+- **Sincronización multi-dispositivo** — Los cambios en el workspace se reflejan en tiempo real
+- **Tailscale** — Acceso HTTPS desde el exterior mediante un túnel cifrado con WireGuard
+- **Autenticación por contraseña** — Hashing scrypt, seguro incluso al exponerlo al exterior
+- **Multilingüe** — 11 idiomas, entre ellos 한국어, English, 日本語, 中文
+
+### Agentes de IA (Beta)
+
+Crea agentes de IA independientes, asígnales roles y personalidades (souls) y ejecuta tareas en paralelo con varias pestañas. Cada agente tiene su propio chat, memoria y workspace.
+
+## Plataformas soportadas
+
+| Plataforma | Estado | Notas |
+|---|---|---|
+| macOS (Apple Silicon / Intel) | ✅ | App de Electron incluida |
+| Linux | ✅ | Sin Electron |
+| Windows | ❌ | No soportado |
+
+## Detalles de instalación
+
+### Requisitos
+
+- macOS 13+ o Linux
+- [Node.js](https://nodejs.org/) 20+
+- [tmux](https://github.com/tmux/tmux)
+
+### npx (el más rápido)
+
+```bash
+npx purplemux
+```
+
+### Instalación global
+
+```bash
+npm install -g purplemux
+purplemux
+```
+
+### Desde el código fuente
+
+```bash
+git clone https://github.com/subicura/purplemux.git
+cd purplemux
+pnpm install
+pnpm start
+```
+
+Modo desarrollo:
+
+```bash
+pnpm dev
+```
+
+#### Nivel de log
+
+Ajusta el nivel global con `LOG_LEVEL` (por defecto `info`).
+
+```bash
+LOG_LEVEL=debug pnpm dev
+```
+
+Para activar módulos concretos, lista pares `módulo=nivel` separados por comas en `LOG_LEVELS`. Niveles disponibles: `trace` / `debug` / `info` / `warn` / `error` / `fatal`.
+
+```bash
+# Rastrea sólo los hooks de Claude Code en debug
+LOG_LEVELS=hooks=debug pnpm dev
+
+# Varios módulos a la vez
+LOG_LEVELS=hooks=debug,status=warn pnpm dev
+```
+
+Los módulos no listados en `LOG_LEVELS` usan el valor de `LOG_LEVEL`.
+
+## Acceso externo (Tailscale Serve)
+
+```bash
+tailscale serve --bg 8022
+```
+
+Accede en `https://<machine>.<tailnet>.ts.net`. Para desactivarlo:
+
+```bash
+tailscale serve --bg off 8022
+```
+
+## Seguridad
+
+### Contraseña
+
+Define una contraseña en el primer acceso. Se guarda con hashing scrypt en `~/.purplemux/config.json`.
+
+Para reiniciarla, elimina `~/.purplemux/config.json` y reinicia: la pantalla de onboarding volverá a aparecer.
+
+### HTTPS
+
+Por defecto usa HTTP. Aplica siempre HTTPS al exponer la aplicación al exterior:
+
+- **Tailscale Serve** — Cifrado WireGuard con certificados automáticos
+- **Nginx / Caddy** — Debe reenviar las cabeceras de upgrade de WebSocket (`Upgrade`, `Connection`)
+
+### Directorio de datos (`~/.purplemux/`)
+
+| Archivo | Descripción |
+|---|---|
+| `config.json` | Credenciales (hash) y ajustes de la app |
+| `workspaces.json` | Diseños de workspace, pestañas y directorios |
+| `vapid-keys.json` | Claves VAPID de Web Push (autogeneradas) |
+| `push-subscriptions.json` | Datos de suscripción push |
+| `hooks/` | Hooks definidos por el usuario |
+
+## Arquitectura
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  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 │ │
+│                              └────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**E/S del terminal** — xterm.js se conecta a node-pty mediante WebSocket y node-pty se acopla a las sesiones de tmux. Un protocolo binario gestiona stdin/stdout/resize con control de backpressure.
+
+**Detección de estado** — Los hooks de eventos de Claude Code (`SessionStart`, `Stop`, `Notification`) envían actualizaciones inmediatas por HTTP POST. Cada 5–15 s se inspeccionan los árboles de procesos y se analizan los últimos 8 KB de los archivos JSONL.
+
+**Timeline** — Observa los logs JSONL de sesiones bajo `~/.claude/projects/`, parsea las nuevas líneas al cambiar el archivo y envía entradas estructuradas al navegador.
+
+**Aislamiento tmux** — Usa un socket `purple` dedicado, totalmente separado de tu tmux actual. Sin tecla prefix ni barra de estado.
+
+**Recuperación automática** — Al iniciar el servidor, restaura las sesiones previas de Claude con `claude --resume {sessionId}`.
+
+## License
+
+[MIT](LICENSE)

package/README.fr.md

@@ -0,0 +1,224 @@
+# purplemux
+
+**Claude Code, plusieurs tâches en même temps. En plus rapide.**
+
+Toutes vos sessions sur un seul écran. Sans coupure, même depuis le téléphone.
+
+<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> | Français | <a href="README.ru.md">Русский</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)
+
+## Installation
+
+```bash
+npx purplemux
+```
+
+Ouvrez [http://localhost:8022](http://localhost:8022) dans votre navigateur. C'est tout.
+
+> Nécessite Node.js 20+ et tmux. macOS ou Linux.
+
+## Pourquoi purplemux
+
+- **Tableau de bord multi-session** — Visualisez d'un coup d'œil l'état « en cours / en attente d'entrée » de toutes vos sessions Claude Code
+- **Suivi des limites** — Solde 5 heures / 7 jours avec compte à rebours de réinitialisation
+- **Notifications push** — Alertes desktop et mobiles lorsqu'une tâche se termine ou attend une entrée
+- **Mobile et multi-appareil** — Accédez à la même session depuis un téléphone, une tablette ou un autre poste
+- **Vue de session en direct** — Plus besoin de faire défiler la sortie CLI : la progression est présentée sous forme de chronologie
+
+Et aussi
+
+- **Sessions ininterrompues** — Basé sur tmux. Fermez le navigateur, tout reste en place. À la reconnexion, vos onglets, panneaux et répertoires sont exactement là où vous les aviez laissés
+- **Auto-hébergé et open source** — Le code et les données de session ne quittent jamais votre machine. Aucun serveur externe
+- **Accès distant chiffré** — HTTPS depuis n'importe où via Tailscale
+
+## Différences avec le Remote Control officiel
+
+> Le Remote Control officiel se concentre sur le contrôle distant d'une session unique. Utilisez purplemux lorsque vous avez besoin de gestion multi-session, de notifications push et de persistance des sessions.
+
+## Fonctionnalités
+
+### Terminal
+
+- **Panneaux scindés** — Découpe horizontale / verticale libre, redimensionnement par glisser
+- **Gestion des onglets** — Onglets multiples, réorganisation par glisser, titres automatiques basés sur les noms de processus
+- **Raccourcis clavier** — Découpe, changement d'onglet, déplacement du focus
+- **Thèmes du terminal** — Mode sombre / clair, plusieurs palettes de couleurs
+- **Workspaces** — Sauvegardez et restaurez la disposition des panneaux, onglets et répertoires par workspace
+- **Visualiseur Git Diff** — Consultez le git diff directement dans un panneau du terminal. Bascule Side-by-side / Line-by-line, avec coloration syntaxique
+- **Panneau navigateur web** — Navigateur intégré à côté du terminal pour vérifier le rendu du développement (Electron)
+
+### Intégration Claude Code
+
+- **État en temps réel** — Indicateurs en cours / en attente d'entrée, bascule entre sessions
+- **Vue de session en direct** — Messages, appels d'outils, tâches, demandes de permission, blocs thinking
+- **Reprise en un clic** — Reprenez une session suspendue directement depuis le navigateur
+- **Reprise automatique** — Restauration automatique des sessions Claude au démarrage du serveur
+- **Prompts rapides** — Enregistrez vos prompts récurrents et envoyez-les en un clic
+- **Historique des messages** — Réutilisez vos anciens messages
+- **Statistiques d'usage** — Tokens (input / output / cache read / cache write), coût, ventilation par projet, rapports IA quotidiens
+- **Rate limits** — Solde 5 heures / 7 jours, compte à rebours de réinitialisation
+
+### Mobile et accessibilité
+
+- **Interface responsive** — Terminal et chronologie sur téléphone et tablette
+- **PWA** — Ajoutez à l'écran d'accueil pour une expérience proche d'une application native
+- **Web Push** — Recevez des notifications même après avoir fermé l'onglet
+- **Synchronisation multi-appareil** — Les modifications de workspace sont répercutées en temps réel
+- **Tailscale** — Accès HTTPS externe via un tunnel chiffré WireGuard
+- **Authentification par mot de passe** — Hachage scrypt, sûr même en exposition publique
+- **Multilingue** — 11 langues dont 한국어, English, 日本語, 中文
+
+### Agents IA (Beta)
+
+Créez des agents IA indépendants, attribuez-leur des rôles et des personnalités (souls) et exécutez des tâches en parallèle via plusieurs onglets. Chaque agent possède son propre chat, sa mémoire et son workspace.
+
+## Plateformes prises en charge
+
+| Plateforme | État | Notes |
+|---|---|---|
+| macOS (Apple Silicon / Intel) | ✅ | Application Electron incluse |
+| Linux | ✅ | Sans Electron |
+| Windows | ❌ | Non pris en charge |
+
+## Détails d'installation
+
+### Prérequis
+
+- macOS 13+ ou Linux
+- [Node.js](https://nodejs.org/) 20+
+- [tmux](https://github.com/tmux/tmux)
+
+### npx (le plus rapide)
+
+```bash
+npx purplemux
+```
+
+### Installation globale
+
+```bash
+npm install -g purplemux
+purplemux
+```
+
+### Depuis les sources
+
+```bash
+git clone https://github.com/subicura/purplemux.git
+cd purplemux
+pnpm install
+pnpm start
+```
+
+Mode développement :
+
+```bash
+pnpm dev
+```
+
+#### Niveau de log
+
+Définissez le niveau global avec `LOG_LEVEL` (par défaut `info`).
+
+```bash
+LOG_LEVEL=debug pnpm dev
+```
+
+Pour n'activer que certains modules, listez les paires `module=niveau` séparées par des virgules dans `LOG_LEVELS`. Niveaux disponibles : `trace` / `debug` / `info` / `warn` / `error` / `fatal`.
+
+```bash
+# Trace uniquement le comportement des hooks Claude Code en debug
+LOG_LEVELS=hooks=debug pnpm dev
+
+# Plusieurs modules simultanément
+LOG_LEVELS=hooks=debug,status=warn pnpm dev
+```
+
+Les modules absents de `LOG_LEVELS` reprennent la valeur de `LOG_LEVEL`.
+
+## Accès externe (Tailscale Serve)
+
+```bash
+tailscale serve --bg 8022
+```
+
+Accédez à `https://<machine>.<tailnet>.ts.net`. Pour désactiver :
+
+```bash
+tailscale serve --bg off 8022
+```
+
+## Sécurité
+
+### Mot de passe
+
+Définissez un mot de passe au premier accès. Il est haché avec scrypt et stocké dans `~/.purplemux/config.json`.
+
+Pour le réinitialiser, supprimez `~/.purplemux/config.json` puis redémarrez : l'écran d'onboarding réapparaît.
+
+### HTTPS
+
+Par défaut, le protocole est HTTP. Utilisez impérativement HTTPS en exposition publique :
+
+- **Tailscale Serve** — Chiffrement WireGuard et certificats automatiques
+- **Nginx / Caddy** — Doit transmettre les en-têtes d'upgrade WebSocket (`Upgrade`, `Connection`)
+
+### Répertoire de données (`~/.purplemux/`)
+
+| Fichier | Description |
+|---|---|
+| `config.json` | Identifiants (hachés) et paramètres de l'application |
+| `workspaces.json` | Dispositions des workspaces, onglets, répertoires |
+| `vapid-keys.json` | Clés VAPID Web Push (générées automatiquement) |
+| `push-subscriptions.json` | Informations d'abonnement push |
+| `hooks/` | Hooks définis par l'utilisateur |
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│  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 │ │
+│                              └────────────────────────────┘ │
+└─────────────────────────────────────────────────────────────┘
+```
+
+**E/S du terminal** — xterm.js se connecte à node-pty via WebSocket, puis node-pty s'attache aux sessions tmux. Un protocole binaire gère stdin/stdout/resize avec contrôle de backpressure.
+
+**Détection d'état** — Les hooks d'événements Claude Code (`SessionStart`, `Stop`, `Notification`) envoient des mises à jour immédiates en HTTP POST. Toutes les 5–15 s, l'arbre de processus est inspecté et les 8 derniers Ko des fichiers JSONL sont analysés.
+
+**Chronologie** — Surveille les logs de session JSONL sous `~/.claude/projects/`, parse les nouvelles lignes à chaque changement et diffuse des entrées structurées vers le navigateur.
+
+**Isolation tmux** — Utilise un socket `purple` dédié, totalement séparé de votre tmux existant. Pas de touche préfixe ni de barre d'état.
+
+**Reprise automatique** — Au démarrage du serveur, les sessions Claude précédentes sont restaurées via `claude --resume {sessionId}`.
+
+## License
+
+[MIT](LICENSE)