codexmate 0.0.4 → 0.0.6

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,27 @@
+---
+name: Bug report
+about: Report a problem with Codex Mate
+labels: bug
+---
+
+**Summary**
+A clear and concise description of the bug.
+
+**Steps to reproduce**
+1.
+2.
+3.
+
+**Expected behavior**
+What you expected to happen.
+
+**Actual behavior**
+What actually happened.
+
+**Environment**
+- OS:
+- Node.js version:
+- Codex Mate version:
+
+**Logs or screenshots**
+Paste relevant logs or screenshots.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest a new idea for Codex Mate
+labels: enhancement
+---
+
+**Problem**
+What problem are you trying to solve?
+
+**Proposed solution**
+Describe the solution you want.
+
+**Alternatives**
+Any alternative solutions or features you considered.
+
+**Additional context**
+Add any other context or screenshots.

package/.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: ci
+on:
+  push:
+  pull_request:
+permissions:
+  contents: read
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        node: [18, 20, 22]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node }}
+          cache: npm
+      - name: Install
+        run: npm ci
+      - name: Lint
+        run: npm run lint --if-present
+      - name: Test
+        run: npm run test --if-present

package/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+## 0.0.5
+
+- Sessions: enable keyword search for Codex-only view
+- Sessions: increase keyword scan limit to reduce misses
+- Utilities: add JS fallback for zip/unzip when 7-Zip is missing
+- UI: shorten base_url/key/model check hint
+
+## 0.0.4
+
+- Added OpenClaw config mode with JSON5 profiles and one-click apply
+- Added OpenClaw workspace AGENTS.md management
+- Added JSON5 parsing dependency

package/CHANGELOG.zh-CN.md

@@ -0,0 +1,14 @@
+# 更新日志
+
+## 0.0.5
+
+- 会话浏览：仅 Codex 支持关键词检索
+- 会话浏览：关键词扫描上限提升，降低漏检
+- 附属功能：7-Zip 缺失时回退内置 JS 压缩/解压
+- 文案：精简检测提示
+
+## 0.0.4
+
+- 新增 OpenClaw 配置模式（JSON5 多配置管理 + 一键应用）
+- 新增 OpenClaw Workspace 的 AGENTS.md 管理
+- 增加 JSON5 解析依赖

package/README.md

@@ -1,60 +1,68 @@
 # Codex Mate
 
-> A lightweight AI configuration assistant: CLI + Web to manage Codex providers/models and Claude Code configs
+> A lightweight AI configuration assistant: quickly switch Codex providers/models and Claude Code configs, with a unified session browser
 
 [![Build](https://img.shields.io/github/actions/workflow/status/ymkiux/codexmate/release.yml?label=build)](https://github.com/ymkiux/codexmate/actions/workflows/release.yml) [![Version](https://img.shields.io/npm/v/codexmate?label=version&registry_uri=https%3A%2F%2Fregistry.npmjs.org)](https://www.npmjs.com/package/codexmate) [![Status](https://img.shields.io/badge/status-alpha-orange)](https://github.com/ymkiux/codexmate)
 [![Maintain](https://img.shields.io/github/commit-activity/m/ymkiux/codexmate?label=maintain%2Fmonth)](https://github.com/ymkiux/codexmate/commits) [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE) [![Node](https://img.shields.io/badge/node-%3E%3D14.0.0-green.svg)](https://nodejs.org)
 
 English | [Chinese](README.zh-CN.md)
 
-## Overview
-
-If you frequently switch between models, providers, or configuration profiles, Codex Mate turns that into a single command or a single click.
-
-## Release Notes (0.0.4)
-
-- Added OpenClaw config mode with JSON5 profiles and one-click apply
-- Added OpenClaw workspace AGENTS.md management
-- Added JSON5 parsing dependency
-
-## What You Get
+## Overview
+
+Codex Mate makes frequent provider/model switching for Codex and Claude Code a single command or click, and gives you a unified session browser to view/export local sessions from both.
+
+## What You Get
 
 - Faster provider/model switching
 - More controllable local configuration management
 - A visual Web UI to reduce CLI burden
 - Change tracking with backups
+- A unified session browser for Codex + Claude Code (view/export/copy resume command when available)
 
 ## Feature Overview
 
-| Module | Problem | Key Capabilities |
-| --- | --- | --- |
-| Codex Config | Switching providers/models is painful | Provider/model switching, model management, CLI + Web entry points, template-confirmed writes |
-| Claude Code Config | Multiple profiles and inconsistent write paths | Profile management, default write to `~/.claude/settings.json`, compatibility mode env vars |
-| OpenClaw Config | OpenClaw configs are scattered | JSON5 profiles, apply to `~/.openclaw/openclaw.json`, AGENTS workspace management |
-| Session Browser | Local sessions are hard to track | List/filter sessions, export to Markdown, delete and batch cleanup |
-| Utilities | Compression/extraction requires extra tools | Multithreaded compress/unzip via 7-Zip |
+| Module | Problem | Key Capabilities |
+| --- | --- | --- |
+| Codex Config | Switching providers/models is painful | Provider/model switching, model management, CLI + Web entry points, template-confirmed writes |
+| Claude Code Config | Multiple profiles and inconsistent write paths | Profile management, default write to `~/.claude/settings.json` |
+| OpenClaw Config | OpenClaw configs are scattered | JSON5 profiles, apply to `~/.openclaw/openclaw.json`, AGENTS workspace management |
+| Session Browser | Local sessions are hard to track | List/filter sessions, export to Markdown, copy resume command (when available), delete and batch cleanup |
+| Utilities | Compression/extraction requires extra tools | 7-Zip preferred, JS fallback |
 
 ## Why Codex Mate
 
-- Focused on three jobs: Codex provider/model switching + Claude Code config apply + OpenClaw config apply
+- Focused on three jobs: Codex provider/model switching + Claude Code config apply + OpenClaw config apply
 - Local-first: configs and API keys are written to local files, not the cloud
 - Lightweight: CLI + Web, no desktop app required
 - Reversible: auto-backup before first takeover
 
 ## Use Cases
 
-- Frequent provider/model switching, want a one-command flow
-- Use both Codex and Claude Code, want a single entry point
-- Use OpenClaw with multiple profiles, want quick switching
-- Multi-project or multi-environment setups that need quick config changes
-- Want a visual UI without a heavy client
+- Frequent provider/model switching, want a one-command flow
+- Use both Codex and Claude Code, want a single entry point
+- Need to browse/export local Codex + Claude Code sessions and copy resume commands when available
+- Use OpenClaw with multiple profiles, want quick switching
+- Multi-project or multi-environment setups that need quick config changes
+- Want a visual UI without a heavy client
 
 ## Scope and Boundaries
 
-- Only configuration management for Codex, Claude Code, and OpenClaw, not a full all-in-one tool suite
+- Only configuration management for Codex, Claude Code, and OpenClaw, not a full all-in-one tool suite
 - No built-in proxy/relay/billing dashboard/cloud sync (kept lightweight)
 - Web UI runs only when you start it (`codexmate start`)
 
+## 30-Second Start (No Install)
+
+```bash
+npx codexmate@latest status
+```
+
+```bash
+npx codexmate@latest start
+```
+
+Then open `http://localhost:3737` in your browser.
+
 ## Quick Start
 
 1. Install (global):
@@ -67,18 +75,27 @@ Or run once without install:
 npx codexmate@latest status
 ```
 
-2. Check status:
+2. Run the interactive setup:
+```bash
+codexmate setup
+```
+
+3. Check status:
 ```bash
 codexmate status
 ```
 
-3. Start the Web UI:
+4. Start the Web UI:
 ```bash
 codexmate start
 ```
 
 Then open `http://localhost:3737` in your browser.
 
+## Alternatives
+
+- cc-switch: https://github.com/farion1231/cc-switch
+
 ## UI Preview
 
 ![Codex Mate Web UI](res/screenshot.png)
@@ -93,10 +110,19 @@ npm install -g codexmate
 
 Package name on npm: `codexmate`.
 
+Want to update to the latest effects features each time? Install from GitHub (re-run to update):
+
+```bash
+npm install -g ymkiux/codexmate
+```
+
 ### Run with npx (No Install)
 
 ```bash
 npx codexmate@latest status
+```
+
+```bash
 npx codexmate@latest start
 ```
 
@@ -119,6 +145,7 @@ npm link
 | Command | Description |
 | --- | --- |
 | `codexmate` | Show help and available commands |
+| `codexmate setup` | Interactive configuration wizard |
 | `codexmate status` | Show current status |
 | `codexmate list` | List all providers |
 | `codexmate switch <provider>` | Switch provider |
@@ -126,9 +153,10 @@ npm link
 | `codexmate add <name> <URL> [API key]` | Add a provider |
 | `codexmate delete <provider>` | Delete a provider |
 | `codexmate models` | List all models |
-| `codexmate add-model <model>` | Add a model |
-| `codexmate delete-model <model>` | Delete a model |
-| `codexmate start` | Start the Web UI |
+| `codexmate add-model <model>` | Add a model |
+| `codexmate delete-model <model>` | Delete a model |
+| `codexmate start` | Start the Web UI |
+| `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | Export a session to Markdown |
 
 ## Web UI
 
@@ -147,25 +175,25 @@ codexmate start
 - Add/delete custom providers
 - Supports Codex config management on Linux/Windows
 
-### Claude Code Config Mode (Windows / macOS / Linux)
-
-- Manage multiple Claude Code profiles
-- Configure API key, Base URL, and model
-- Default write to `env` in `~/.claude/settings.json`: `env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_AUTH_TOKEN` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL` / `env.CLAUDE_CODE_USE_KEY`
-- Compatibility mode: write to system environment variables (useful for legacy workflows or specific Windows cases)
-
-### OpenClaw Config Mode
-
-- Manage multiple OpenClaw JSON5 profiles
-- Apply to `~/.openclaw/openclaw.json`
-- Manage `AGENTS.md` under the OpenClaw Workspace (default: `~/.openclaw/workspace/AGENTS.md`)
-
-### Session Browser
+### Claude Code Config Mode (Windows / macOS / Linux)
+
+- Manage multiple Claude Code profiles
+- Configure API key, Base URL, and model
+- Default write to `env` in `~/.claude/settings.json`: `env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
+
+### OpenClaw Config Mode
+
+- Manage multiple OpenClaw JSON5 profiles
+- Apply to `~/.openclaw/openclaw.json`
+- Manage `AGENTS.md` under the OpenClaw Workspace (default: `~/.openclaw/workspace/AGENTS.md`)
+
+### Session Browser
 
 - View local Codex and Claude Code sessions in one page
 - Filter by source (Codex / Claude / All)
 - Filter by session path (cwd), auto refresh on selection
 - Export selected sessions to Markdown
+- Copy resume command when available
 - Delete single sessions (local jsonl records)
 - Batch delete multiple sessions with partial failure summary
 - Delete individual records or multi-select within session details (writes back to original jsonl)
@@ -187,15 +215,15 @@ Config directory: `~/.codex/`
 - `codexmate-init.json` - First-run marker
 - `config.toml.codexmate-backup-*.bak` - Backup created on first takeover
 
-Claude Code config files:
-
-- `~/.claude/settings.json` - Runtime config (default write target)
-- `~/.claude/settings.json.codexmate-backup-*.bak` - Backup before first overwrite
-
-OpenClaw config files:
-
-- `~/.openclaw/openclaw.json` - OpenClaw config (JSON5)
-- `~/.openclaw/workspace/AGENTS.md` - OpenClaw workspace instructions
+Claude Code config files:
+
+- `~/.claude/settings.json` - Runtime config (default write target)
+- `~/.claude/settings.json.codexmate-backup-*.bak` - Backup before first overwrite
+
+OpenClaw config files:
+
+- `~/.openclaw/openclaw.json` - OpenClaw config (JSON5)
+- `~/.openclaw/workspace/AGENTS.md` - OpenClaw workspace instructions
 
 ## First Run Initialization
 
@@ -215,34 +243,49 @@ codexmate add myapi https://api.example.com/v1 sk-your-api-key
 codexmate switch myapi
 ```
 
-### Switch to a Different Model
-
-```bash
-codexmate use gpt-4-turbo
-```
-
-### Configure Claude Code (Cross-Platform)
+### Switch to a Different Model
+
+```bash
+codexmate use gpt-4-turbo
+```
+
+### Export a Session (CLI)
+
+```bash
+codexmate export-session --source codex --session-id 123456
+codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl" --max-messages=all
+```
+
+By default, exports are capped at 1000 messages. Use `--max-messages=all` (or `Infinity`) to export everything.
+
+### Configure Claude Code (Cross-Platform)
 
 1. Start the Web UI: `codexmate start`
 2. Switch to "Claude Code Config" mode in the browser
 3. Add a profile (example Zhipu GLM): Name=ZhipuGLM, API Key=your API key, Base URL=`https://open.bigmodel.cn/api/anthropic`, Model=`glm-4.7`
 4. Click the card to apply, or use "Save & Apply to Claude Config" in the editor
-5. Default write to `~/.claude/settings.json`; compatibility mode writes system env vars
+5. Default write to `~/.claude/settings.json`
 6. Restart Claude Code to apply
 
-### Start the Web UI
-
-```bash
-codexmate start
-```
-
-Then open `http://localhost:3737`.
+### Start the Web UI
+
+```bash
+codexmate start
+```
+
+By default it binds to `127.0.0.1`. To expose on LAN, use `--host` or `CODEXMATE_HOST`:
+
+```bash
+codexmate start --host 0.0.0.0
+```
+
+Then open `http://localhost:3737` (or your chosen host). Note: binding to `0.0.0.0` is unsafe on untrusted networks.
 
 ## FAQ
 
 ### Q: Which operating systems are supported?
 
-A: Codex features support Windows and Linux (CLI and Web). Claude Code config applies to Windows / macOS / Linux (writes to `~/.claude/settings.json`). Compatibility mode env vars are Windows-only.
+A: Codex features support Windows and Linux (CLI and Web). Claude Code config applies to Windows / macOS / Linux (writes to `~/.claude/settings.json`).
 
 ### Q: Where are API keys stored?
 
@@ -254,15 +297,15 @@ A: The Web UI runs locally; all operations happen on your machine. API keys are
 
 ### Q: How do Claude Code configs take effect?
 
-A: After clicking "Apply to Claude Config", it writes to `~/.claude/settings.json`. Restart Claude Code to apply. If using compatibility mode env vars, a restart is also recommended.
+A: After clicking "Apply to Claude Config", it writes to `~/.claude/settings.json`. Restart Claude Code to apply.
 
 ### Q: How to uninstall?
 
 A: Run `npm uninstall -g codexmate`.
 
-## Extras: Multithreaded Compression/Extraction
+## Extras: Compression/Extraction
 
-Based on 7-Zip for multithreaded zip/unzip.
+Prefer 7-Zip for multithreaded zip/unzip. Fallback to the built-in JS library when unavailable.
 
 ```bash
 # Compress file or folder (default compression level 5)
@@ -297,7 +340,7 @@ codexmate unzip ./my-project.zip
 codexmate unzip ./backup.zip D:/restored
 ```
 
-Note: Requires [7-Zip](https://www.7-zip.org/) installed.
+Note: 7-Zip is optional. If missing, the built-in JS library is used. `--max` only applies to 7-Zip.
 
 ## Tech Stack