purplemux 0.3.0 → 0.3.2

package/README.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code, many tasks at once. Faster.**
+**Claude Code and Codex, many tasks at once. Faster.**
 
 Every session on a single screen. Uninterrupted, even on your phone.
 
@@ -24,7 +24,7 @@ Prefer a native app? Grab the macOS Electron build from the [latest release](htt
 
 ## Why purplemux
 
-- **Multi-session dashboard** — See working/needs-input status for every Claude Code session at a glance
+- **Multi-session dashboard** — See working/needs-input status for every Claude Code and Codex session at a glance
 - **Rate limit monitoring** — 5-hour / 7-day remaining usage with reset countdown
 - **Push notifications** — Desktop and mobile alerts when a task finishes or needs input
 - **Mobile & multi-device** — Reach the same session from a phone, tablet, or another desktop
@@ -49,20 +49,23 @@ Plus
 - **Keyboard shortcuts** — Splits, tab switching, focus movement
 - **Terminal themes** — Dark / light mode, multiple color themes
 - **Workspaces & groups** — Save and restore panel layouts, tabs, and working directories. Organize workspaces into groups with drag-and-drop
-- **Git workflow** — Side-by-side / line-by-line diff with syntax highlighting, inline hunk expansion, and a paginated history tab. Fetch / pull / push from the panel with ahead/behind indicators — if sync fails (dirty worktree, conflicts), Ask Claude in one click
+- **Git workflow** — Side-by-side / line-by-line diff with syntax highlighting, inline hunk expansion, and a paginated history tab. Fetch / pull / push from the panel with ahead/behind indicators — if sync fails (dirty worktree, conflicts), Ask Claude or Codex in one click
 - **Web browser panel** — Embedded browser for checking dev output (Electron). Drive it from the `purplemux` CLI and switch viewports with a built-in device emulator
+- **Agent tabs** — Start Claude, Codex, or a combined session list from the new-tab menu
 
-### Claude Code integration
+### Claude Code and Codex integration
 
 - **Real-time status** — Working / needs-input indicators with session switching
 - **Live session view** — Messages, tool calls, tasks, permission prompts, thinking blocks
-- **One-click resume** — Restart a paused session directly from the browser
+- **Codex tabs** — Launch Codex CLI sessions with the same tmux-backed persistence as Claude
+- **Session list** — Browse and resume recent Claude and Codex sessions from one combined view
+- **One-click resume** — Restart a paused Claude or Codex session directly from the browser
 - **Auto resume** — Recover previous Claude sessions on server start
 - **Quick prompts** — Register frequently used prompts and send with one click
 - **Attachments** — Drop images into the chat input, or attach files to insert their paths. Works on mobile
 - **Message history** — Reuse previous messages
-- **Usage analytics** — Tokens (input / output / cache read / cache write), cost, per-project breakdowns, daily AI reports
-- **Rate limits** — 5-hour / 7-day remaining usage with reset countdown
+- **Usage analytics** — Claude + Codex tokens, cost, per-project breakdowns, and daily AI reports
+- **Rate limits** — 5-hour / 7-day remaining usage with reset countdown for supported providers
 
 ### Mobile & accessibility
 
@@ -90,6 +93,22 @@ Plus
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Required for Claude tabs. Install Claude Code and sign in before starting a Claude tab:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# or, with Homebrew latest channel
+brew install --cask claude-code@latest
+```
+
+Optional for Codex tabs. Install Codex CLI and sign in before starting a Codex tab:
+
+```bash
+npm i -g @openai/codex
+# or
+brew install --cask codex
+```
+
 ### npx (fastest)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### CLI examples
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### Run from source
 
 ```bash
@@ -199,24 +225,25 @@ The default is HTTP. Always use HTTPS when exposing the app externally:
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  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 connects to node-pty via WebSocket; node-pty attaches to tmux sessions. A binary protocol handles stdin/stdout/resize with backpressure control.
 
-**Status detection** — Claude Code event hooks (`SessionStart`, `Stop`, `Notification`) deliver instant updates via HTTP POST. Polling every 5–15s inspects process trees and analyzes the last 8KB of JSONL files.
+**Status detection** — Agent event hooks deliver instant updates via HTTP POST. Claude Code uses `SessionStart`, `Stop`, and `Notification`; Codex uses `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop`, and `PermissionRequest`. Polling every 5–15s inspects process trees and analyzes the last 8KB of JSONL files.
 
-**Timeline** — Watches JSONL session logs under `~/.claude/projects/`, parses new lines on change, and streams structured entries to the browser.
+**Timeline** — Watches JSONL session logs under `~/.claude/projects/` and `~/.codex/sessions/`, parses new lines on change, and streams structured entries to the browser.
 
 **tmux isolation** — Uses a dedicated `purple` socket, completely separate from your existing tmux. No prefix key, no status bar.
 
-**Auto recovery** — On server start, restores previous Claude sessions via `claude --resume {sessionId}`.
+**Auto recovery** — On server start, restores previous Claude sessions via `claude --resume {sessionId}`. Codex sessions can be resumed from the session list or with `codex resume {sessionId}`.
 
 ## License
 

package/README.pt-BR.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code, várias tarefas ao mesmo tempo. Mais rápido.**
+**Claude Code e Codex, várias tarefas ao mesmo tempo. Mais rápido.**
 
 Todas as sessões em uma tela só. Sem quebras, até no celular.
 
@@ -24,7 +24,7 @@ Prefere um app nativo? Baixe a versão Electron para macOS na [última release](
 
 ## Por que purplemux
 
-- **Painel multissessão** — Veja o status «trabalhando / aguardando entrada» de todas as sessões do Claude Code de relance
+- **Painel multissessão** — Veja o status «trabalhando / aguardando entrada» de todas as sessões do Claude Code e do Codex 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
@@ -49,20 +49,23 @@ E ainda
 - **Atalhos de teclado** — Divisão, troca de abas, movimento de foco
 - **Temas do terminal** — Modo escuro / claro e vários esquemas de cores
 - **Workspaces e grupos** — Salve e restaure layouts de painéis, abas e diretórios de trabalho por workspace. Organize os workspaces em grupos com arrastar e soltar
-- **Fluxo de trabalho Git** — Side-by-side / Line-by-line com destaque de sintaxe, expansão de hunks inline e uma aba de histórico paginada. Fetch / pull / push direto do painel com indicadores ahead/behind — se o sync falhar (dirty worktree, conflitos), Ask Claude em um clique
+- **Fluxo de trabalho Git** — Side-by-side / Line-by-line com destaque de sintaxe, expansão de hunks inline e uma aba de histórico paginada. Fetch / pull / push direto do painel com indicadores ahead/behind — se o sync falhar (dirty worktree, conflitos), Ask Claude ou Codex em um clique
 - **Painel de navegador web** — Navegador embutido ao lado do terminal para conferir o resultado de desenvolvimento (Electron). Controle pelo CLI `purplemux` e alterne viewports com um emulador de dispositivo integrado
+- **Abas de agentes** — Inicie Claude, Codex ou uma lista de sessões combinada pelo menu de nova aba
 
-### Integração com Claude Code
+### Integração com Claude Code e Codex
 
 - **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
+- **Abas Codex** — Inicie sessões do Codex CLI com a mesma persistência baseada em tmux do Claude
+- **Lista de sessões** — Navegue e retome sessões recentes do Claude e do Codex em uma visualização combinada
+- **Resume em um clique** — Retome sessões pausadas do Claude ou do Codex 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
 - **Anexos** — Solte imagens no campo de chat ou anexe arquivos para inserir o caminho. Funciona também no mobile
 - **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
+- **Estatísticas de uso** — Tokens do Claude + Codex, 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 para provedores compatíveis
 
 ### Mobile e acessibilidade
 
@@ -90,6 +93,22 @@ E ainda
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Necessário para abas Claude. Instale o Claude Code e faça login antes de iniciar uma aba Claude:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# ou com o canal latest do Homebrew
+brew install --cask claude-code@latest
+```
+
+Opcional para abas Codex. Instale o Codex CLI e faça login antes de iniciar uma aba Codex:
+
+```bash
+npm i -g @openai/codex
+# ou
+brew install --cask codex
+```
+
 ### npx (mais rápido)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### Exemplos de CLI
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### A partir do código-fonte
 
 ```bash
@@ -199,24 +225,25 @@ Por padrão, o protocolo é HTTP. Sempre use HTTPS ao expor externamente:
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  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 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.
+**Detecção de status** — Os hooks de eventos dos agentes entregam atualizações imediatas via HTTP POST. Claude Code usa `SessionStart`, `Stop` e `Notification`; Codex usa `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop` e `PermissionRequest`. 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.
+**Timeline** — Observa os logs de sessão JSONL em `~/.claude/projects/` e `~/.codex/sessions/`, 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}`.
+**Recuperação automática** — Ao iniciar o servidor, sessões anteriores do Claude são restauradas via `claude --resume {sessionId}`. Sessões do Codex podem ser retomadas pela lista de sessões ou com `codex resume {sessionId}`.
 
 ## License
 

package/README.ru.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 дней и обратный отсчёт до сброса
 - **Push-уведомления** — оповещения на десктопе и мобильном, когда задача завершена или нужен ввод
 - **Мобильность и мульти-устройства** — доступ к одной и той же сессии с телефона, планшета или другого рабочего места
@@ -49,20 +49,23 @@ npx purplemux@latest
 - **Горячие клавиши** — разделение, переключение вкладок, перемещение фокуса
 - **Темы терминала** — тёмный / светлый режим, несколько цветовых тем
 - **Рабочие пространства и группы** — сохранение и восстановление раскладки панелей, вкладок и рабочих каталогов в пределах рабочего пространства. Объединяйте рабочие пространства в группы перетаскиванием
-- **Git-воркфлоу** — Side-by-side / Line-by-line с подсветкой синтаксиса, инлайновое раскрытие hunk и отдельная вкладка истории с пагинацией. Fetch / pull / push прямо из панели с индикаторами ahead/behind — при ошибке синхронизации (dirty worktree, конфликты) можно в один клик Ask Claude
+- **Git-воркфлоу** — Side-by-side / Line-by-line с подсветкой синтаксиса, инлайновое раскрытие hunk и отдельная вкладка истории с пагинацией. Fetch / pull / push прямо из панели с индикаторами ahead/behind — при ошибке синхронизации (dirty worktree, конфликты) можно в один клик Ask Claude или Codex
 - **Панель веб-браузера** — встроенный браузер рядом с терминалом для проверки результата разработки (Electron). Управляется через CLI `purplemux`, со встроенным эмулятором устройств для переключения viewport
+- **Вкладки агентов** — запускайте Claude, Codex или общий список сессий из меню новой вкладки
 
-### Интеграция с Claude Code
+### Интеграция с Claude Code и Codex
 
 - **Статус в реальном времени** — индикаторы «работает / ждёт ввода», переключение между сессиями
 - **Live-вид сессии** — сообщения, вызовы инструментов, задачи, запросы разрешений, блоки thinking
-- **Resume в один клик** — возобновляйте приостановленную сессию прямо из браузера
+- **Вкладки Codex** — запускайте сессии Codex CLI с той же tmux-персистентностью, что и Claude
+- **Список сессий** — просматривайте и возобновляйте недавние сессии 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 latest channel
+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 подключается к node-pty через WebSocket, а node-pty — к сессиям tmux. Бинарный протокол обрабатывает stdin/stdout/resize с контролем backpressure.
 
-**Определение статуса** — хуки событий Claude Code (`SessionStart`, `Stop`, `Notification`) мгновенно доставляют обновления по HTTP POST. Каждые 5–15 с проверяется дерево процессов и анализируются последние 8 КБ JSONL-файла.
+**Определение статуса** — хуки событий агентов мгновенно доставляют обновления по HTTP POST. Claude Code использует `SessionStart`, `Stop` и `Notification`; Codex использует `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop` и `PermissionRequest`. Каждые 5–15 с проверяется дерево процессов и анализируются последние 8 КБ JSONL-файла.
 
-**Таймлайн** — отслеживает JSONL-логи сессий в `~/.claude/projects/`, разбирает новые строки при изменении файла и транслирует структурированные записи в браузер.
+**Таймлайн** — отслеживает JSONL-логи сессий в `~/.claude/projects/` и `~/.codex/sessions/`, разбирает новые строки при изменении файла и транслирует структурированные записи в браузер.
 
 **Изоляция tmux** — используется отдельный сокет `purple`, полностью независимый от уже работающего tmux. Без prefix-клавиши и статус-бара.
 
-**Автовосстановление** — при старте сервера предыдущие сессии Claude восстанавливаются через `claude --resume {sessionId}`.
+**Автовосстановление** — при старте сервера предыдущие сессии Claude восстанавливаются через `claude --resume {sessionId}`. Сессии Codex можно возобновить из списка сессий или командой `codex resume {sessionId}`.
 
 ## License
 

package/README.tr.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code, birden çok işi aynı anda. Daha hızlı.**
+**Claude Code ve Codex, birden çok işi aynı anda. Daha hızlı.**
 
 Tüm oturumlarınız tek bir ekranda. Telefonda bile kopuksuz.
 
@@ -24,7 +24,7 @@ Yerel bir uygulama mı tercih edersiniz? macOS Electron sürümünü [en son sü
 
 ## Neden purplemux
 
-- **Çoklu oturum panosu** — Tüm Claude Code oturumlarının «çalışıyor / giriş bekliyor» durumunu tek bakışta görün
+- **Çoklu oturum panosu** — Tüm Claude Code ve Codex oturumlarının «çalışıyor / giriş bekliyor» durumunu tek bakışta görün
 - **Rate limit takibi** — 5 saat / 7 gün kalan kullanım ve sıfırlama geri sayımı
 - **Push bildirimleri** — Görev bitince veya giriş gerektiğinde masaüstü ve mobil uyarılar
 - **Mobil ve çoklu cihaz** — Aynı oturuma telefonunuzdan, tabletinizden veya başka bir masaüstünden erişin
@@ -49,20 +49,23 @@ Ayrıca
 - **Klavye kısayolları** — Bölme, sekme değiştirme, odak hareketi
 - **Terminal temaları** — Koyu / açık mod, çeşitli renk temaları
 - **Çalışma alanları & gruplar** — Panel düzenini, sekmeleri ve çalışma dizinlerini çalışma alanı bazında kaydedin ve geri yükleyin. Çalışma alanlarını sürükle-bırak ile gruplara ayırarak yönetin
-- **Git iş akışı** — Side-by-side / Line-by-line geçişi ve sözdizimi vurgulamasıyla birlikte satır içi hunk genişletme ve sayfalandırılmış geçmiş sekmesi. Panelden doğrudan fetch / pull / push (ahead/behind göstergeleriyle) — sync başarısız olursa (dirty worktree, çakışma) tek tıkla Ask Claude
+- **Git iş akışı** — Side-by-side / Line-by-line geçişi ve sözdizimi vurgulamasıyla birlikte satır içi hunk genişletme ve sayfalandırılmış geçmiş sekmesi. Panelden doğrudan fetch / pull / push (ahead/behind göstergeleriyle) — sync başarısız olursa (dirty worktree, çakışma) tek tıkla Ask Claude veya Codex
 - **Web tarayıcı paneli** — Geliştirme çıktısını kontrol etmek için terminalin yanında gömülü tarayıcı (Electron). `purplemux` CLI'dan kontrol edin ve dahili cihaz öykünücüsüyle viewport'u değiştirin
+- **Ajan sekmeleri** — Yeni sekme menüsünden Claude, Codex veya birleşik oturum listesini başlatın
 
-### Claude Code entegrasyonu
+### Claude Code ve Codex entegrasyonu
 
 - **Gerçek zamanlı durum** — Çalışıyor / giriş bekliyor göstergeleri ve oturumlar arası geçiş
 - **Canlı oturum görünümü** — Mesajlar, araç çağrıları, görevler, izin istekleri ve thinking blokları
-- **Tek tıkla Resume** — Duraklatılmış oturumu doğrudan tarayıcıdan devam ettirin
+- **Codex sekmeleri** — Claude ile aynı tmux tabanlı kalıcılıkla Codex CLI oturumları başlatın
+- **Oturum listesi** — Yakın tarihli Claude ve Codex oturumlarını tek birleşik görünümden inceleyin ve devam ettirin
+- **Tek tıkla Resume** — Duraklatılmış Claude veya Codex oturumunu doğrudan tarayıcıdan devam ettirin
 - **Otomatik Resume** — Sunucu başlatıldığında önceki Claude oturumlarını otomatik olarak kurtarır
 - **Hızlı prompt'lar** — Sık kullanılan prompt'ları kaydedin ve tek tıkla gönderin
 - **Ekler** — Sohbet alanına görseller bırakın veya dosya ekleyerek yolunu otomatik ekletin. Mobilde de çalışır
 - **Mesaj geçmişi** — Önceki mesajları tekrar kullanın
-- **Kullanım istatistikleri** — Token'lar (input / output / cache read / cache write), maliyet, proje bazlı kırılım, günlük AI raporları
-- **Rate limit** — 5 saat / 7 gün kalan kullanım ve sıfırlama geri sayımı
+- **Kullanım istatistikleri** — Claude + Codex token'ları, maliyet, proje bazlı kırılım, günlük AI raporları
+- **Rate limit** — Desteklenen sağlayıcılar için 5 saat / 7 gün kalan kullanım ve sıfırlama geri sayımı
 
 ### Mobil ve erişilebilirlik
 
@@ -90,6 +93,22 @@ Ayrıca
 - [Node.js](https://nodejs.org/) 20+
 - [tmux](https://github.com/tmux/tmux)
 
+Claude sekmeleri için gereklidir. Claude Code'u kurun ve Claude sekmesi başlatmadan önce giriş yapın:
+
+```bash
+curl -fsSL https://claude.ai/install.sh | bash
+# veya Homebrew latest kanalıyla
+brew install --cask claude-code@latest
+```
+
+Codex sekmeleri için isteğe bağlıdır. Codex CLI'ı kurun ve Codex sekmesi başlatmadan önce giriş yapın:
+
+```bash
+npm i -g @openai/codex
+# veya
+brew install --cask codex
+```
+
 ### npx (en hızlısı)
 
 ```bash
@@ -103,6 +122,13 @@ npm install -g purplemux
 purplemux
 ```
 
+### CLI örnekleri
+
+```bash
+purplemux tab create -w WS -t codex-cli -n "fix auth"
+purplemux tab create -w WS -t agent-sessions
+```
+
 ### Kaynaktan çalıştırma
 
 ```bash
@@ -199,24 +225,25 @@ Varsayılan protokol HTTP'dir. Dışarı açarken mutlaka HTTPS kullanın:
         ▼                ▼                     ▼
 ┌─────────────────────────────────────────────────────────────┐
 │  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 G/Ç** — xterm.js, node-pty'ye WebSocket üzerinden bağlanır; node-pty ise tmux oturumlarına iliştirilir. İkili bir protokol stdin/stdout/resize işlemlerini backpressure kontrolüyle yürütür.
 
-**Durum algılama** — Claude Code olay hook'ları (`SessionStart`, `Stop`, `Notification`) HTTP POST ile anında güncelleme gönderir. Her 5–15 sn'de bir süreç ağacı kontrol edilir ve JSONL dosyalarının son 8 KB'si analiz edilir.
+**Durum algılama** — Ajan olay hook'ları HTTP POST ile anında güncelleme gönderir. Claude Code `SessionStart`, `Stop` ve `Notification` kullanır; Codex `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PostToolUse`, `Stop` ve `PermissionRequest` kullanır. Her 5–15 sn'de bir süreç ağacı kontrol edilir ve JSONL dosyalarının son 8 KB'si analiz edilir.
 
-**Zaman tüneli** — `~/.claude/projects/` altındaki JSONL oturum loglarını izler, değişiklikte yeni satırları ayrıştırır ve yapılandırılmış girişleri tarayıcıya akıtır.
+**Zaman tüneli** — `~/.claude/projects/` ve `~/.codex/sessions/` altındaki JSONL oturum loglarını izler, değişiklikte yeni satırları ayrıştırır ve yapılandırılmış girişleri tarayıcıya akıtır.
 
 **tmux izolasyonu** — Mevcut tmux'unuzdan tamamen ayrı, özel bir `purple` soketi kullanır. Prefix tuşu yok, durum çubuğu yok.
 
-**Otomatik kurtarma** — Sunucu başlatıldığında önceki Claude oturumları `claude --resume {sessionId}` ile geri yüklenir.
+**Otomatik kurtarma** — Sunucu başlatıldığında önceki Claude oturumları `claude --resume {sessionId}` ile geri yüklenir. Codex oturumları oturum listesinden veya `codex resume {sessionId}` ile devam ettirilebilir.
 
 ## License
 

package/README.zh-CN.md

@@ -1,6 +1,6 @@
 # purplemux
 
-**Claude Code,多任务同时进行。更快。**
+**Claude Code 与 Codex,多任务同时进行。更快。**
 
 一屏纵览所有会话,在手机上也毫无中断。
 
@@ -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、冲突) 一键 Ask Claude
+- **Git 工作流** — 支持 Side-by-side / Line-by-line 切换与语法高亮,以及行内 hunk 展开、分页历史标签。可从面板直接 fetch / pull / push (含 ahead/behind 指示) — 同步失败时 (dirty worktree、冲突) 一键 Ask 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 会话
 - **快速提示** — 注册常用提示,一键发送
 - **附件** — 在聊天输入中拖入图片,或附加文件以自动插入路径。移动端同样可用
 - **消息历史** — 复用之前的消息
-- **用量统计** — Token (input / output / cache read / cache write)、成本、按项目拆分、每日 AI 报告
-- **速率限制** — 5 小时 / 7 天剩余额度,重置倒计时
+- **用量统计** — Claude + Codex Token、成本、按项目拆分、每日 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 事件 hook (`SessionStart`、`Stop`、`Notification`) 通过 HTTP POST 立即推送更新。每 5–15 秒轮询一次进程树,并分析 JSONL 文件末尾 8KB。
+**状态检测** — 智能体事件 hook 通过 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` socket,与现有 tmux 完全隔离。无前缀键,无状态栏。
 
-**自动恢复** — 服务器启动时通过 `claude --resume {sessionId}` 恢复之前的 Claude 会话。
+**自动恢复** — 服务器启动时通过 `claude --resume {sessionId}` 恢复之前的 Claude 会话。Codex 会话可从会话列表恢复,也可使用 `codex resume {sessionId}`。
 
 ## License