purplemux 0.3.0 → 0.3.2

package/README.de.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code, viele Aufgaben gleichzeitig. Schneller.**
+**Claude Code und Codex, viele Aufgaben gleichzeitig. Schneller.**
 
 Alle Sessions auf einem Bildschirm. Unterbrechungsfrei, auch auf dem Handy.
 
@@ -24,7 +24,7 @@ Lieber eine native App? Hol dir den macOS-Electron-Build aus dem [neuesten Relea
 
 ## Warum purplemux
 
-- **Multi-Session-Dashboard** — Behalte „arbeitet / wartet auf Eingabe"-Status aller Claude-Code-Sessions auf einen Blick im Überblick
+- **Multi-Session-Dashboard** — Behalte „arbeitet / wartet auf Eingabe"-Status aller Claude-Code- und Codex-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
@@ -49,20 +49,23 @@ Außerdem
 - **Tastenkürzel** — Splits, Tab-Wechsel, Fokusbewegung
 - **Terminal-Themes** — Dark-/Light-Modus, mehrere Farbschemata
 - **Workspaces & Gruppen** — Panel-Layouts, Tabs und Arbeitsverzeichnisse pro Workspace speichern und wiederherstellen. Workspaces per Drag-and-Drop in Gruppen organisieren
-- **Git-Workflow** — Side-by-side / Line-by-line mit Syntax-Highlighting, Inline-Hunk-Erweiterung und ein paginierter Verlaufs-Tab. Fetch / Pull / Push direkt aus dem Panel (mit Ahead/Behind-Anzeige) — schlägt der Sync fehl (dirty worktree, Konflikte), per Klick Claude fragen
+- **Git-Workflow** — Side-by-side / Line-by-line mit Syntax-Highlighting, Inline-Hunk-Erweiterung und ein paginierter Verlaufs-Tab. Fetch / Pull / Push direkt aus dem Panel (mit Ahead/Behind-Anzeige) — schlägt der Sync fehl (dirty worktree, Konflikte), per Klick Claude oder Codex fragen
 - **Webbrowser-Panel** — Eingebetteter Browser neben dem Terminal zum Prüfen der Entwicklungsausgabe (Electron). Über die `purplemux`-CLI steuerbar, mit eingebautem Geräte-Emulator zum Umschalten der Viewports
+- **Agent-Tabs** — Starte Claude, Codex oder eine kombinierte Session-Liste über das Neuer-Tab-Menü
 
-### Claude-Code-Integration
+### Claude-Code- und Codex-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
+- **Codex-Tabs** — Starte Codex-CLI-Sessions mit derselben tmux-basierten Persistenz wie Claude
+- **Session-Liste** — Durchsuche und setze aktuelle Claude- und Codex-Sessions in einer kombinierten Ansicht fort
+- **Ein-Klick-Resume** — Unterbrochene Claude- oder Codex-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
 - **Anhänge** — Bilder direkt in die Chat-Eingabe ziehen oder Dateien anhängen, deren Pfad automatisch eingefügt wird. Funktioniert auch mobil
 - **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
+- **Nutzungsstatistik** — Claude + Codex Tokens, Kosten, Auswertung pro Projekt, tägliche KI-Berichte
+- **Rate-Limits** — Restkontingent 5 Stunden / 7 Tage mit Reset-Countdown für unterstützte Provider
 
 ### Mobil & Zugänglichkeit
 
@@ -90,6 +93,22 @@ Außerdem
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Erforderlich für Claude-Tabs. Installiere Claude Code und melde dich an, bevor du einen Claude-Tab startest:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# oder mit dem Homebrew-Latest-Channel
+brew install --cask claude-code@latest
+```
+
+Optional für Codex-Tabs. Installiere Codex CLI und melde dich an, bevor du einen Codex-Tab startest:
+
+```bash
+npm i -g @openai/codex
+# oder
+brew install --cask codex
+```
+
 ### npx (am schnellsten)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### CLI-Beispiele
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### Aus dem Quellcode
 
 ```bash
@@ -199,24 +225,25 @@ Standard ist HTTP. Bei externer Erreichbarkeit unbedingt HTTPS verwenden:
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  System                                                     │
-│  tmux (purple socket)         Claude Code                   │
+│  tmux (purple socket)         Agent CLIs                    │
 │  ┌────────┐ ┌────────┐       ┌────────────────────────────┐ │
-│  │Session1│ │Session2│  ...  │ ~/.claude/sessions/        │ │
-│  │ (shell)│ │ (shell)│       │ ~/.claude/projects/        │ │
-│  └────────┘ └────────┘       │   └─ {project}/{sid}.jsonl │ │
+│  │Session1│ │Session2│  ...  │ Claude Code                │ │
+│  │ (shell)│ │ (shell)│       │   ~/.claude/projects/*.jsonl │ │
+│  └────────┘ └────────┘       │ Codex                      │ │
+│                              │   ~/.codex/sessions/*.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.
+**Statuserkennung** — Agent-Event-Hooks liefern sofortige Updates per HTTP POST. Claude Code nutzt `SessionStart`, `Stop` und `Notification`; Codex nutzt `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop` und `PermissionRequest`. 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.
+**Timeline** — Überwacht JSONL-Session-Logs unter `~/.claude/projects/` und `~/.codex/sessions/`, 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.
+**Auto-Recovery** — Beim Serverstart werden vorherige Claude-Sessions via `claude --resume {sessionId}` wiederhergestellt. Codex-Sessions lassen sich über die Session-Liste oder mit `codex resume {sessionId}` fortsetzen.
 
 ## License
 

package/README.es.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code, muchas tareas a la vez. Más rápido.**
+**Claude Code y Codex, muchas tareas a la vez. Más rápido.**
 
 Todas tus sesiones en una sola pantalla. Sin interrupciones, incluso desde el móvil.
 
@@ -24,7 +24,7 @@ Abre [http://localhost:8022](http://localhost:8022) en tu navegador. Listo.
 
 ## Por qué purplemux
 
-- **Panel multisesión** — Consulta de un vistazo el estado «trabajando / requiere entrada» de todas tus sesiones de Claude Code
+- **Panel multisesión** — Consulta de un vistazo el estado «trabajando / requiere entrada» de todas tus sesiones de Claude Code y Codex
 - **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
@@ -49,20 +49,23 @@ Además
 - **Atajos de teclado** — División, cambio de pestaña, movimiento de foco
 - **Temas de terminal** — Modo oscuro / claro y varios esquemas de color
 - **Workspaces y grupos** — Guarda y restaura diseños de paneles, pestañas y directorios de trabajo por workspace. Organiza los workspaces en grupos con arrastrar y soltar
-- **Flujo de trabajo Git** — Side-by-side / Line-by-line con resaltado de sintaxis, expansión de hunks en línea y una pestaña de historial paginada. Fetch / pull / push desde el panel con indicadores ahead/behind — si la sincronización falla (dirty worktree, conflictos), Ask Claude con un clic
+- **Flujo de trabajo Git** — Side-by-side / Line-by-line con resaltado de sintaxis, expansión de hunks en línea y una pestaña de historial paginada. Fetch / pull / push desde el panel con indicadores ahead/behind — si la sincronización falla (dirty worktree, conflictos), Ask Claude o Codex con un clic
 - **Panel de navegador web** — Navegador integrado junto al terminal para comprobar la salida de desarrollo (Electron). Contrólalo desde la CLI `purplemux` y cambia el viewport con un emulador de dispositivo integrado
+- **Pestañas de agentes** — Inicia Claude, Codex o una lista de sesiones combinada desde el menú de nueva pestaña
 
-### Integración con Claude Code
+### Integración con Claude Code y Codex
 
 - **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
+- **Pestañas Codex** — Inicia sesiones de Codex CLI con la misma persistencia basada en tmux que Claude
+- **Lista de sesiones** — Explora y reanuda sesiones recientes de Claude y Codex desde una vista combinada
+- **Reanudación en un clic** — Retoma una sesión pausada de Claude o Codex 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
 - **Adjuntos** — Suelta imágenes en el cuadro de chat o adjunta archivos para insertar su ruta. También funciona en móvil
 - **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
+- **Estadísticas de uso** — Tokens de Claude + Codex, 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 en proveedores compatibles
 
 ### Móvil y accesibilidad
 
@@ -90,6 +93,22 @@ Además
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Requerido para pestañas de Claude. Instala Claude Code e inicia sesión antes de abrir una pestaña de Claude:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# o con el canal latest de Homebrew
+brew install --cask claude-code@latest
+```
+
+Opcional para pestañas de Codex. Instala Codex CLI e inicia sesión antes de abrir una pestaña de Codex:
+
+```bash
+npm i -g @openai/codex
+# o
+brew install --cask codex
+```
+
 ### npx (el más rápido)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### Ejemplos de CLI
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### Desde el código fuente
 
 ```bash
@@ -199,24 +225,25 @@ Por defecto usa HTTP. Aplica siempre HTTPS al exponer la aplicación al exterior
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  System                                                     │
-│  tmux (purple socket)         Claude Code                   │
+│  tmux (purple socket)         Agent CLIs                    │
 │  ┌────────┐ ┌────────┐       ┌────────────────────────────┐ │
-│  │Session1│ │Session2│  ...  │ ~/.claude/sessions/        │ │
-│  │ (shell)│ │ (shell)│       │ ~/.claude/projects/        │ │
-│  └────────┘ └────────┘       │   └─ {project}/{sid}.jsonl │ │
+│  │Session1│ │Session2│  ...  │ Claude Code                │ │
+│  │ (shell)│ │ (shell)│       │   ~/.claude/projects/*.jsonl │ │
+│  └────────┘ └────────┘       │ Codex                      │ │
+│                              │   ~/.codex/sessions/*.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.
+**Detección de estado** — Los hooks de eventos de los agentes envían actualizaciones inmediatas por HTTP POST. Claude Code usa `SessionStart`, `Stop` y `Notification`; Codex usa `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop` y `PermissionRequest`. 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.
+**Timeline** — Observa los logs JSONL de sesiones bajo `~/.claude/projects/` y `~/.codex/sessions/`, 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}`.
+**Recuperación automática** — Al iniciar el servidor, restaura las sesiones previas de Claude con `claude --resume {sessionId}`. Las sesiones de Codex pueden reanudarse desde la lista de sesiones o con `codex resume {sessionId}`.
 
 ## License
 

package/README.fr.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code, plusieurs tâches en même temps. En plus rapide.**
+**Claude Code et Codex, 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.
 
@@ -24,7 +24,7 @@ Vous préférez une app native ? Récupérez la build Electron macOS depuis la [
 
 ## 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
+- **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 et Codex
 - **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
@@ -49,20 +49,23 @@ Et aussi
 - **Raccourcis clavier** — Découpe, changement d'onglet, déplacement du focus
 - **Thèmes du terminal** — Mode sombre / clair, plusieurs palettes de couleurs
 - **Workspaces et groupes** — Sauvegardez et restaurez la disposition des panneaux, onglets et répertoires par workspace. Organisez les workspaces en groupes par glisser-déposer
-- **Flux de travail Git** — Side-by-side / Line-by-line avec coloration syntaxique, expansion des hunks en ligne et un onglet d'historique paginé. Fetch / pull / push depuis le panneau, avec indicateurs ahead/behind — si la synchronisation échoue (dirty worktree, conflits), Ask Claude en un clic
+- **Flux de travail Git** — Side-by-side / Line-by-line avec coloration syntaxique, expansion des hunks en ligne et un onglet d'historique paginé. Fetch / pull / push depuis le panneau, avec indicateurs ahead/behind — si la synchronisation échoue (dirty worktree, conflits), Ask Claude ou Codex en un clic
 - **Panneau navigateur web** — Navigateur intégré à côté du terminal pour vérifier le rendu du développement (Electron). Pilotable depuis la CLI `purplemux` et changement de viewport via un émulateur d'appareil intégré
+- **Onglets d'agents** — Lancez Claude, Codex ou une liste de sessions combinée depuis le menu nouvel onglet
 
-### Intégration Claude Code
+### Intégration Claude Code et Codex
 
 - **É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
+- **Onglets Codex** — Lancez des sessions Codex CLI avec la même persistance basée sur tmux que Claude
+- **Liste de sessions** — Parcourez et reprenez les sessions Claude et Codex récentes depuis une vue combinée
+- **Reprise en un clic** — Reprenez une session Claude ou Codex 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
 - **Pièces jointes** — Déposez des images dans le champ de chat, ou attachez des fichiers pour insérer leur chemin. Fonctionne aussi sur mobile
 - **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
+- **Statistiques d'usage** — Tokens Claude + Codex, coût, ventilation par projet, rapports IA quotidiens
+- **Rate limits** — Solde 5 heures / 7 jours avec compte à rebours de réinitialisation pour les fournisseurs pris en charge
 
 ### Mobile et accessibilité
 
@@ -90,6 +93,22 @@ Et aussi
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Requis pour les onglets Claude. Installez Claude Code et connectez-vous avant de démarrer un onglet Claude :
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# ou avec le canal latest de Homebrew
+brew install --cask claude-code@latest
+```
+
+Optionnel pour les onglets Codex. Installez Codex CLI et connectez-vous avant de démarrer un onglet Codex :
+
+```bash
+npm i -g @openai/codex
+# ou
+brew install --cask codex
+```
+
 ### npx (le plus rapide)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### Exemples CLI
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### Depuis les sources
 
 ```bash
@@ -199,24 +225,25 @@ Par défaut, le protocole est HTTP. Utilisez impérativement HTTPS en exposition
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  System                                                     │
-│  tmux (purple socket)         Claude Code                   │
+│  tmux (purple socket)         Agent CLIs                    │
 │  ┌────────┐ ┌────────┐       ┌────────────────────────────┐ │
-│  │Session1│ │Session2│  ...  │ ~/.claude/sessions/        │ │
-│  │ (shell)│ │ (shell)│       │ ~/.claude/projects/        │ │
-│  └────────┘ └────────┘       │   └─ {project}/{sid}.jsonl │ │
+│  │Session1│ │Session2│  ...  │ Claude Code                │ │
+│  │ (shell)│ │ (shell)│       │   ~/.claude/projects/*.jsonl │ │
+│  └────────┘ └────────┘       │ Codex                      │ │
+│                              │   ~/.codex/sessions/*.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.
+**Détection d'état** — Les hooks d'événements des agents envoient des mises à jour immédiates en HTTP POST. Claude Code utilise `SessionStart`, `Stop` et `Notification`; Codex utilise `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop` et `PermissionRequest`. 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.
+**Chronologie** — Surveille les logs de session JSONL sous `~/.claude/projects/` et `~/.codex/sessions/`, 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}`.
+**Reprise automatique** — Au démarrage du serveur, les sessions Claude précédentes sont restaurées via `claude --resume {sessionId}`. Les sessions Codex peuvent être reprises depuis la liste des sessions ou avec `codex resume {sessionId}`.
 
 ## License
 

package/README.ja.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code、複数のタスクを同時に。もっと速く。**
+**Claude Code と Codex、複数のタスクを同時に。もっと速く。**
 
 1 つの画面ですべてのセッションを、スマホでも途切れることなく。
 
@@ -24,7 +24,7 @@ npx purplemux@latest
 
 ## purplemux を選ぶ理由
 
-- **マルチセッションダッシュボード** — すべての Claude Code セッションの「作業中 / 入力待ち」ステータスを一目で把握
+- **マルチセッションダッシュボード** — すべての Claude Code と Codex セッションの「作業中 / 入力待ち」ステータスを一目で把握
 - **レート制限モニタリング** — 5 時間 / 7 日の残量とリセットまでのカウントダウンを表示
 - **プッシュ通知** — タスク完了や入力要求をデスクトップ / モバイルへ通知
 - **モバイル & マルチデバイス** — スマホ、タブレット、別のデスクトップからも同じセッションへ
@@ -49,20 +49,23 @@ npx purplemux@latest
 - **キーボードショートカット** — 分割、タブ切り替え、フォーカス移動
 - **ターミナルテーマ** — ダーク / ライトモード、多彩なカラーテーマ
 - **ワークスペース & グループ** — ペインレイアウト、タブ、作業ディレクトリをワークスペース単位で保存 / 復元。ドラッグ & ドロップでワークスペースをグループ化して管理
-- **Git ワークフロー** — Side-by-side / Line-by-line 切り替えとシンタックスハイライトに加え、インライン hunk 展開、ページネーション付き履歴タブ。パネルから直接 fetch / pull / push (ahead/behind 表示) — 同期失敗 (dirty worktree、コンフリクト) はワンクリックで Claude に質問
+- **Git ワークフロー** — Side-by-side / Line-by-line 切り替えとシンタックスハイライトに加え、インライン hunk 展開、ページネーション付き履歴タブ。パネルから直接 fetch / pull / push (ahead/behind 表示) — 同期失敗 (dirty worktree、コンフリクト) はワンクリックで Claude または Codex に質問
 - **Web ブラウザペイン** — ターミナル隣の組み込みブラウザで開発結果を確認 (Electron)。`purplemux` CLI から操作でき、内蔵のデバイスエミュレータでビューポートを切り替え
+- **エージェントタブ** — 新規タブメニューから Claude、Codex、または統合セッション一覧を開始
 
-### Claude Code 連携
+### Claude Code と Codex 連携
 
 - **リアルタイムステータス** — 作業中 / 入力待ちインジケーター、セッション間の切り替え
 - **ライブセッションビュー** — メッセージ、ツール呼び出し、タスク、権限リクエスト、thinking ブロック
-- **ワンクリック Resume** — 中断したセッションをブラウザからそのまま再開
+- **Codex タブ** — Claude と同じ tmux ベースの永続性で Codex CLI セッションを起動
+- **セッション一覧** — 最近の Claude と Codex セッションを 1 つの統合ビューで参照・再開
+- **ワンクリック Resume** — 中断した Claude または Codex セッションをブラウザからそのまま再開
 - **自動 Resume** — サーバー起動時に以前の Claude セッションを自動復元
 - **クイックプロンプト** — よく使うプロンプトを登録してワンクリック送信
 - **添付** — チャット入力に画像をドロップ、またはファイル添付でパスを自動挿入。モバイルでも動作
 - **メッセージ履歴** — 過去のメッセージを再利用
-- **使用量分析** — トークン (input / output / cache read / cache write)、コスト、プロジェクト別分析、日次 AI レポート
-- **レート制限** — 5 時間 / 7 日の残量、リセットまでのカウントダウン
+- **使用量分析** — Claude + Codex のトークン、コスト、プロジェクト別分析、日次 AI レポート
+- **レート制限** — 対応プロバイダーの 5 時間 / 7 日の残量、リセットまでのカウントダウン
 
 ### モバイル & アクセシビリティ
 
@@ -90,6 +93,22 @@ npx purplemux@latest
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Claude タブに必要です。Claude Code をインストールし、Claude タブを開始する前にログインしてください:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# または Homebrew latest チャンネル
+brew install --cask claude-code@latest
+```
+
+Codex タブは任意です。Codex CLI をインストールし、Codex タブを開始する前にログインしてください:
+
+```bash
+npm i -g @openai/codex
+# または
+brew install --cask codex
+```
+
 ### npx (最速)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### CLI 例
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### ソースから実行
 
 ```bash
@@ -199,24 +225,25 @@ tailscale serve --bg off 8022
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  System                                                     │
-│  tmux (purple socket)         Claude Code                   │
+│  tmux (purple socket)         Agent CLIs                    │
 │  ┌────────┐ ┌────────┐       ┌────────────────────────────┐ │
-│  │Session1│ │Session2│  ...  │ ~/.claude/sessions/        │ │
-│  │ (shell)│ │ (shell)│       │ ~/.claude/projects/        │ │
-│  └────────┘ └────────┘       │   └─ {project}/{sid}.jsonl │ │
+│  │Session1│ │Session2│  ...  │ Claude Code                │ │
+│  │ (shell)│ │ (shell)│       │   ~/.claude/projects/*.jsonl │ │
+│  └────────┘ └────────┘       │ Codex                      │ │
+│                              │   ~/.codex/sessions/*.jsonl │ │
 │                              └────────────────────────────┘ │
 └─────────────────────────────────────────────────────────────┘
 ```
 
 **ターミナル I/O** — xterm.js は WebSocket 経由で node-pty に接続し、node-pty は tmux セッションにアタッチされます。バイナリプロトコルで stdin / stdout / resize を処理し、バックプレッシャーを制御します。
 
-**ステータス検出** — Claude Code イベントフック (`SessionStart`, `Stop`, `Notification`) が HTTP POST で即時更新を配信します。5〜15 秒ごとにプロセスツリーを確認し、JSONL ファイル末尾 8KB を解析します。
+**ステータス検出** — エージェントイベントフックが HTTP POST で即時更新を配信します。Claude Code は `SessionStart`、`Stop`、`Notification` を使用し、Codex は `SessionStart`、`UserPromptSubmit`、`PreToolUse`、`PostToolUse`、`Stop`、`PermissionRequest` を使用します。5〜15 秒ごとにプロセスツリーを確認し、JSONL ファイル末尾 8KB を解析します。
 
-**タイムライン** — `~/.claude/projects/` 配下の JSONL セッションログを監視し、変更時に新しい行をパースして構造化エントリをブラウザへストリーミングします。
+**タイムライン** — `~/.claude/projects/` と `~/.codex/sessions/` 配下の JSONL セッションログを監視し、変更時に新しい行をパースして構造化エントリをブラウザへストリーミングします。
 
 **tmux 分離** — 専用の `purple` ソケットを使用し、既存の tmux と完全に分離されています。prefix キーなし、ステータスバーなし。
 
-**自動復旧** — サーバー起動時に `claude --resume {sessionId}` で以前の Claude セッションを復元します。
+**自動復旧** — サーバー起動時に `claude --resume {sessionId}` で以前の Claude セッションを復元します。Codex セッションはセッション一覧または `codex resume {sessionId}` で再開できます。
 
 ## License
 

package/README.ko.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code, 여러 작업을 동시에. 더 빠르게.**
+**Claude Code와 Codex, 여러 작업을 동시에. 더 빠르게.**
 
 한 화면에서 모든 세션을, 폰에서도 끊김 없이.
 
@@ -24,7 +24,7 @@ npx purplemux@latest
 
 ## 왜 purplemux인가
 
-- **멀티 세션 대시보드** — 모든 Claude Code 세션의 작업중/사용자 요청 상태를 한눈에 확인
+- **멀티 세션 대시보드** — 모든 Claude Code와 Codex 세션의 작업중/사용자 요청 상태를 한눈에 확인
 - **Rate Limit 모니터링** — 5시간/7일 잔여량과 리셋 카운트다운 표시
 - **푸시 알림** — 작업 완료나 입력이 필요하면 데스크탑/모바일 알림
 - **모바일 & 멀티 디바이스** — 폰, 태블릿, 다른 데스크탑 어디서든 같은 세션에 접속
@@ -49,20 +49,23 @@ npx purplemux@latest
 - **키보드 단축키** — 분할, 탭 전환, 포커스 이동
 - **터미널 테마** — 다크/라이트 모드, 다양한 컬러 테마
 - **워크스페이스 & 그룹** — 패널 레이아웃, 탭, 작업 디렉토리를 워크스페이스 단위로 저장/복원. 드래그 앤 드롭으로 워크스페이스를 그룹으로 묶어 관리
-- **Git 워크플로** — Side-by-side / Line-by-line 뷰 전환과 Syntax highlighting, 인라인 hunk 펼치기, 페이지네이션 히스토리 탭. 패널에서 바로 fetch / pull / push (ahead/behind 표시) — 동기화 실패(dirty worktree, 충돌)는 원클릭으로 Claude에게 질문
+- **Git 워크플로** — Side-by-side / Line-by-line 뷰 전환과 Syntax highlighting, 인라인 hunk 펼치기, 페이지네이션 히스토리 탭. 패널에서 바로 fetch / pull / push (ahead/behind 표시) — 동기화 실패(dirty worktree, 충돌)는 원클릭으로 Claude 또는 Codex에게 질문
 - **웹 브라우저 패널** — 터미널 옆 내장 브라우저로 개발 결과 확인 (Electron). `purplemux` CLI로 제어하고, 내장 디바이스 에뮬레이터로 뷰포트 전환
+- **에이전트 탭** — 새 탭 메뉴에서 Claude, Codex 또는 통합 세션 목록 시작
 
-### Claude Code 연동
+### Claude Code와 Codex 연동
 
 - **실시간 상태** — 작업중/사용자 요청 상태 표시, 세션 간 전환
 - **라이브 세션 뷰** — 메시지, 도구 호출, 태스크, 권한 요청, thinking 블록
-- **원클릭 Resume** — 중단된 세션을 브라우저에서 바로 재개
+- **Codex 탭** — Claude와 동일한 tmux 기반 지속성으로 Codex CLI 세션 실행
+- **세션 목록** — 최근 Claude와 Codex 세션을 하나의 통합 뷰에서 탐색하고 재개
+- **원클릭 Resume** — 중단된 Claude 또는 Codex 세션을 브라우저에서 바로 재개
 - **자동 Resume** — 서버 시작 시 이전 Claude 세션 자동 복구
 - **빠른 프롬프트** — 자주 쓰는 프롬프트 등록, 원클릭 전송
 - **첨부** — 채팅 입력에 이미지 드롭, 파일 첨부 시 경로 자동 삽입. 모바일에서도 동작
 - **메시지 히스토리** — 이전 메시지 재사용
-- **사용량 통계** — 토큰(input/output/cache read/cache write), 비용, 프로젝트별 분석, 일별 AI 리포트
-- **Rate Limit** — 5시간/7일 잔여량, 리셋 카운트다운
+- **사용량 통계** — Claude + Codex 토큰, 비용, 프로젝트별 분석, 일별 AI 리포트
+- **Rate Limit** — 지원되는 에이전트의 5시간/7일 잔여량, 리셋 카운트다운
 
 ### 모바일 & 접근성
 
@@ -90,6 +93,22 @@ npx purplemux@latest
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Claude 탭에 필요합니다. Claude Code를 설치하고 Claude 탭을 시작하기 전에 로그인하세요:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# 또는 Homebrew 최신 채널
+brew install --cask claude-code@latest
+```
+
+Codex 탭은 선택 사항입니다. Codex CLI를 설치하고 Codex 탭을 시작하기 전에 로그인하세요:
+
+```bash
+npm i -g @openai/codex
+# 또는
+brew install --cask codex
+```
+
 ### npx (가장 빠름)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### CLI 예시
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### 소스에서 실행
 
 ```bash
@@ -199,24 +225,25 @@ tailscale serve --bg off 8022
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  System                                                     │
-│  tmux (purple socket)         Claude Code                   │
+│  tmux (purple socket)         Agent CLIs                    │
 │  ┌────────┐ ┌────────┐       ┌────────────────────────────┐ │
-│  │Session1│ │Session2│  ...  │ ~/.claude/sessions/        │ │
-│  │ (shell)│ │ (shell)│       │ ~/.claude/projects/        │ │
-│  └────────┘ └────────┘       │   └─ {project}/{sid}.jsonl │ │
+│  │Session1│ │Session2│  ...  │ Claude Code                │ │
+│  │ (shell)│ │ (shell)│       │   ~/.claude/projects/*.jsonl │ │
+│  └────────┘ └────────┘       │ Codex                      │ │
+│                              │   ~/.codex/sessions/*.jsonl │ │
 │                              └────────────────────────────┘ │
 └─────────────────────────────────────────────────────────────┘
 ```
 
 **터미널 I/O** — xterm.js가 WebSocket으로 node-pty에 연결되고, node-pty는 tmux 세션에 연결됩니다. 이진 프로토콜로 stdin/stdout/resize를 처리하며 백프레셔를 제어합니다.
 
-**상태 감지** — Claude Code 이벤트 훅(`SessionStart`, `Stop`, `Notification`)이 HTTP POST로 즉시 업데이트를 전달합니다. 5–15초마다 프로세스 트리를 확인하고 JSONL 파일의 마지막 8KB를 분석합니다.
+**상태 감지** — 에이전트 이벤트 훅이 HTTP POST로 즉시 업데이트를 전달합니다. Claude Code는 `SessionStart`, `Stop`, `Notification`을 사용하고, Codex는 `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`, `PermissionRequest`를 사용합니다. 5–15초마다 프로세스 트리를 확인하고 JSONL 파일의 마지막 8KB를 분석합니다.
 
-**타임라인** — `~/.claude/projects/` 아래 JSONL 세션 로그를 감시하여 변경 시 새 줄을 파싱하고 구조화된 항목을 브라우저에 스트리밍합니다.
+**타임라인** — `~/.claude/projects/`와 `~/.codex/sessions/` 아래 JSONL 세션 로그를 감시하여 변경 시 새 줄을 파싱하고 구조화된 항목을 브라우저에 스트리밍합니다.
 
 **tmux 격리** — 전용 `purple` 소켓을 사용하여 기존 tmux와 완전히 분리됩니다. prefix 키 없음, status bar 없음.
 
-**자동 복구** — 서버 시작 시 `claude --resume {sessionId}`로 이전 Claude 세션을 복원합니다.
+**자동 복구** — 서버 시작 시 `claude --resume {sessionId}`로 이전 Claude 세션을 복원합니다. Codex 세션은 세션 목록 또는 `codex resume {sessionId}`로 재개할 수 있습니다.
 
 ## License