codexmate 0.0.3 → 0.0.5

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/release.yml

@@ -1,45 +1,45 @@
-name: release
+name: release
 run-name: "${{ github.event.repository.name }} ${{ inputs.tag }}"
-on:
-  workflow_dispatch:
-    inputs:
-      tag:
-        description: 'Tag to release (e.g., v0.0.1)'
-        required: true
-permissions:
-  contents: write
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout tag
-        uses: actions/checkout@v4
-        with:
-          ref: ${{ inputs.tag }}
-          fetch-depth: 0
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '18'
-          cache: 'npm'
-      - name: Verify tag matches package.json version
-        run: |
-          node -e "const pkg=require('./package.json'); const tag='${{ inputs.tag }}'; const expected='v'+pkg.version; if(tag!==expected){ console.error('Tag '+tag+' does not match package.json version '+expected); process.exit(1);} console.log('Tag matches '+expected);"
-      - name: Compute release name
-        run: |
-          node -e "const p=require('./package.json'); const tag='${{ inputs.tag }}'; const name=p.name.includes('/')? p.name.split('/')[1]: p.name; const value=name+' '+tag; console.log('RELEASE_NAME='+value);" >> "$GITHUB_ENV"
-      - name: Pack npm artifact
-        run: |
-          name=$(node -e "const p=require('./package.json'); const n=p.name.replace('@','').replace('/','-'); process.stdout.write(n+'-'+p.version+'.tgz');")
-          npm pack
-          test -f "$name"
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag to release (e.g., v0.0.1)'
+        required: true
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout tag
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ inputs.tag }}
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+      - name: Verify tag matches package.json version
+        run: |
+          node -e "const pkg=require('./package.json'); const tag='${{ inputs.tag }}'; const expected='v'+pkg.version; if(tag!==expected){ console.error('Tag '+tag+' does not match package.json version '+expected); process.exit(1);} console.log('Tag matches '+expected);"
+      - name: Compute release name
+        run: |
+          node -e "const p=require('./package.json'); const tag='${{ inputs.tag }}'; const name=p.name.includes('/')? p.name.split('/')[1]: p.name; const value=name+' '+tag; console.log('RELEASE_NAME='+value);" >> "$GITHUB_ENV"
+      - name: Pack npm artifact
+        run: |
+          name=$(node -e "const p=require('./package.json'); const n=p.name.replace('@','').replace('/','-'); process.stdout.write(n+'-'+p.version+'.tgz');")
+          npm pack
+          test -f "$name"
           echo "PACKAGE_TGZ=$name" >> "$GITHUB_ENV"
-      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: ${{ inputs.tag }}
-          name: ${{ env.RELEASE_NAME }}
-          prerelease: false
-          draft: false
-          files: ${{ env.PACKAGE_TGZ }}
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ inputs.tag }}
+          name: ${{ env.RELEASE_NAME }}
+          prerelease: false
+          draft: false
+          files: ${{ env.PACKAGE_TGZ }}
           generate_release_notes: true

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 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,7 @@
+# 更新日志
+
+## 0.0.4
+
+- 新增 OpenClaw 配置模式（JSON5 多配置管理 + 一键应用）
+- 新增 OpenClaw Workspace 的 AGENTS.md 管理
+- 增加 JSON5 解析依赖

package/README.md

@@ -1,15 +1,23 @@
 # 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)
+[![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.
+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.
+
+## 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
+
+See [CHANGELOG.md](CHANGELOG.md) and [Releases](https://github.com/ymkiux/codexmate/releases) for the full history.
 
 ## What You Get
 
@@ -17,19 +25,21 @@ If you frequently switch between models, providers, or configuration profiles, C
 - 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 |
-| Session Browser | Local sessions are hard to track | List/filter sessions, export to Markdown, delete and batch cleanup |
+| 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 | Multithreaded compress/unzip via 7-Zip |
 
 ## Why Codex Mate
 
-- Focused on two jobs: Codex provider/model switching + Claude Code 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
@@ -38,61 +48,93 @@ If you frequently switch between models, providers, or configuration profiles, C
 
 - 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 and Claude Code, 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):
-```bash
-npm install -g codexmate
-```
-
-Or run once without install:
-```bash
-npx codexmate@latest status
-```
-
-2. Check status:
-```bash
-codexmate status
-```
-
-3. Start the Web UI:
+1. Install (global):
+```bash
+npm install -g codexmate
+```
+
+Or run once without install:
+```bash
+npx codexmate@latest status
+```
+
+2. Run the interactive setup:
+```bash
+codexmate setup
+```
+
+3. Check status:
+```bash
+codexmate status
+```
+
+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)
 
 ## Install
 
-### Global (Recommended)
-
-```bash
-npm install -g codexmate
-```
-
-Package name on npm: `codexmate`.
-
-### Run with npx (No Install)
-
-```bash
-npx codexmate@latest status
-npx codexmate@latest start
-```
-
-### From Source
+### Global (Recommended)
+
+```bash
+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
+```
+
+### From Source
 
 ```bash
 git clone https://github.com/ymkiux/codexmate.git
@@ -111,6 +153,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 |
@@ -143,8 +186,13 @@ codexmate start
 
 - 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)
+- 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
 
@@ -152,6 +200,7 @@ codexmate start
 - 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)
@@ -178,6 +227,11 @@ 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
 
 When you run `codexmate` for the first time and an existing `~/.codex/config.toml` is detected that is not managed by Codex Mate:
@@ -208,7 +262,7 @@ codexmate use gpt-4-turbo
 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
@@ -223,7 +277,7 @@ Then open `http://localhost:3737`.
 
 ### 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?
 
@@ -235,7 +289,7 @@ 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?
 
@@ -280,20 +334,20 @@ codexmate unzip ./backup.zip D:/restored
 
 Note: Requires [7-Zip](https://www.7-zip.org/) installed.
 
-## Tech Stack
-
-- **Node.js** - Runtime
-- **@iarna/toml** - TOML parser
-- **Vue.js 3** - Web UI framework
-- **Native HTTP** - Built-in Web server
-
-## Release (GitHub Actions)
-
-Create a tag that matches `package.json` (for example `v0.0.1`). Then run the `release` workflow in GitHub Actions and input that tag. It will create a GitHub Release and attach the `npm pack` `.tgz` artifact.
-
-## License
-
-Apache-2.0 © [ymkiux](https://github.com/ymkiux)
+## Tech Stack
+
+- **Node.js** - Runtime
+- **@iarna/toml** - TOML parser
+- **Vue.js 3** - Web UI framework
+- **Native HTTP** - Built-in Web server
+
+## Release (GitHub Actions)
+
+Create a tag that matches `package.json` (for example `v0.0.1`). Then run the `release` workflow in GitHub Actions and input that tag. It will create a GitHub Release and attach the `npm pack` `.tgz` artifact.
+
+## License
+
+Apache-2.0 © [ymkiux](https://github.com/ymkiux)
 
 ## Contributing