codexmate 0.0.7 → 0.0.8

package/.github/workflows/release.yml

@@ -1,11 +1,12 @@
 name: release
-run-name: "${{ github.event.repository.name }} ${{ inputs.tag }}"
+run-name: "${{ github.event.repository.name }} ${{ inputs.tag || 'auto' }}"
 on:
   workflow_dispatch:
     inputs:
       tag:
-        description: 'Tag to release (e.g., v0.0.1)'
-        required: true
+        description: 'Tag (e.g., v0.0.1). Empty = latest tag.'
+        required: false
+        default: ''
 permissions:
   contents: write
 
@@ -13,21 +14,134 @@ jobs:
   release:
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout tag
+      - name: Checkout
         uses: actions/checkout@v4
         with:
-          ref: ${{ inputs.tag }}
           fetch-depth: 0
+          fetch-tags: true
+      - name: Fetch tags
+        run: git fetch --tags --force
       - uses: actions/setup-node@v4
         with:
           node-version: '18'
           cache: 'npm'
+      - name: Resolve release tag
+        id: resolve
+        env:
+          INPUT_TAG: ${{ inputs.tag }}
+        run: |
+          node - <<'NODE'
+          const { execSync } = require('child_process');
+          const fs = require('fs');
+
+          const inputTagRaw = (process.env.INPUT_TAG || '').trim();
+          const normalizeTag = (tag) => tag.startsWith('v') ? tag.slice(1) : tag;
+          const isSemver = (version) => /^\d+\.\d+\.\d+$/.test(version);
+          const parseSemver = (version) => {
+            if (!isSemver(version)) return null;
+            const [major, minor, patch] = version.split('.').map(n => Number(n));
+            return { major, minor, patch };
+          };
+
+          let latestTag = '';
+          try {
+            latestTag = execSync("git tag --list 'v*' --sort=-v:refname | head -n 1", { encoding: 'utf8' }).trim();
+          } catch (e) {
+            latestTag = '';
+          }
+
+          const pkg = require('./package.json');
+          const pkgVersion = pkg.version;
+          if (!isSemver(pkgVersion)) {
+            console.error(`package.json version ${pkgVersion} is not a valid semver.`);
+            process.exit(1);
+          }
+
+          const latestVersion = latestTag ? normalizeTag(latestTag) : '';
+          const latestSemver = latestVersion ? parseSemver(latestVersion) : null;
+
+          let resolvedTag = '';
+          let expectedVersion = '';
+          let mode = '';
+          let baseVersion = '';
+          let baseSource = '';
+
+          if (inputTagRaw) {
+            if (!/^v?\d+\.\d+\.\d+$/.test(inputTagRaw)) {
+              console.error('Invalid tag format. Use vX.Y.Z or X.Y.Z.');
+              process.exit(1);
+            }
+            resolvedTag = inputTagRaw.startsWith('v') ? inputTagRaw : `v${inputTagRaw}`;
+            expectedVersion = normalizeTag(resolvedTag);
+            mode = 'manual';
+          } else {
+            mode = 'auto';
+            if (!latestTag) {
+              console.error('No git tag found. Please create an initial tag or use manual tag input.');
+              process.exit(1);
+            }
+            if (!latestSemver) {
+              console.error(`Latest tag ${latestTag} is not a valid semver.`);
+              process.exit(1);
+            }
+            resolvedTag = latestTag;
+            expectedVersion = latestVersion;
+            baseVersion = latestVersion;
+            baseSource = 'latest_tag';
+          }
+
+          const envLines = [
+            `RELEASE_TAG=${resolvedTag}`,
+            `RELEASE_VERSION=${expectedVersion}`,
+            `RELEASE_MODE=${mode}`,
+            `LATEST_TAG=${latestTag}`,
+            `PACKAGE_VERSION=${pkgVersion}`,
+            `BASE_VERSION=${baseVersion}`,
+            `BASE_SOURCE=${baseSource}`
+          ].join('\n') + '\n';
+          fs.appendFileSync(process.env.GITHUB_ENV, envLines);
+
+          const outputLines = [
+            `release_tag=${resolvedTag}`,
+            `release_version=${expectedVersion}`,
+            `release_mode=${mode}`,
+            `latest_tag=${latestTag}`,
+            `package_version=${pkgVersion}`,
+            `base_version=${baseVersion}`,
+            `base_source=${baseSource}`
+          ].join('\n') + '\n';
+          fs.appendFileSync(process.env.GITHUB_OUTPUT, outputLines);
+
+          const summaryLines = [
+            '### Release Preview',
+            `- mode: ${mode}`,
+            `- input_tag: ${inputTagRaw || '(empty)'}`,
+            `- latest_tag: ${latestTag || '(none)'}`,
+            `- package_version: ${pkgVersion}`,
+            `- base_version: ${baseVersion || '(none)'}`,
+            `- base_source: ${baseSource || '(none)'}`,
+            `- resolved_tag: ${resolvedTag}`,
+            `- expected_version: ${expectedVersion}`
+          ].join('\n');
+          fs.appendFileSync(process.env.GITHUB_STEP_SUMMARY, summaryLines + '\n');
+          console.log(`::notice title=Resolved Tag::${resolvedTag}`);
+          NODE
+      - name: Checkout target tag
+        env:
+          RELEASE_TAG: ${{ steps.resolve.outputs.release_tag }}
+        run: |
+          git rev-parse "refs/tags/${RELEASE_TAG}" >/dev/null 2>&1
+          git checkout "${RELEASE_TAG}"
       - name: Verify tag matches package.json version
+        env:
+          RELEASE_TAG: ${{ steps.resolve.outputs.release_tag }}
         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);"
+          node -e "const pkg=require('./package.json'); const tag=process.env.RELEASE_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
+        env:
+          RELEASE_TAG: ${{ steps.resolve.outputs.release_tag }}
         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"
+          node -e "const p=require('./package.json'); const tag=process.env.RELEASE_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');")
@@ -37,7 +151,7 @@ jobs:
       - name: Create GitHub Release
         uses: softprops/action-gh-release@v2
         with:
-          tag_name: ${{ inputs.tag }}
+          tag_name: ${{ steps.resolve.outputs.release_tag }}
           name: ${{ env.RELEASE_NAME }}
           prerelease: false
           draft: false

package/README.md

@@ -49,7 +49,7 @@ Codex Mate makes frequent provider/model switching for Codex and Claude Code a s
 
 - 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`)
+- Web UI runs only when you start it (`codexmate run`)
 
 ## 30-Second Start (No Install)
 
@@ -58,7 +58,7 @@ npx codexmate@latest status
 ```
 
 ```bash
-npx codexmate@latest start
+npx codexmate@latest run
 ```
 
 Then open `http://localhost:3737` in your browser.
@@ -87,7 +87,7 @@ codexmate status
 
 4. Start the Web UI:
 ```bash
-codexmate start
+codexmate run
 ```
 
 Then open `http://localhost:3737` in your browser.
@@ -123,7 +123,7 @@ npx codexmate@latest status
 ```
 
 ```bash
-npx codexmate@latest start
+npx codexmate@latest run
 ```
 
 ### From Source
@@ -152,18 +152,19 @@ npm link
 | `codexmate use <model>` | Switch model |
 | `codexmate add <name> <URL> [API key]` | Add a provider |
 | `codexmate delete <provider>` | Delete a provider |
+| `codexmate claude <BaseURL> <API key> [model]` | Write Claude Code config to `~/.claude/settings.json` |
 | `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 export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | Export a session to Markdown |
+| `codexmate add-model <model>` | Add a model |
+| `codexmate delete-model <model>` | Delete a model |
+| `codexmate run` | 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
 
 Start the Web UI (auto opens browser):
 
 ```bash
-codexmate start
+codexmate run
 ```
 
 ### Codex Config Mode
@@ -180,6 +181,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_BASE_URL` / `env.ANTHROPIC_MODEL`
+- One-liner apply via CLI:
+
+```bash
+codexmate claude https://api.example.com/v1 sk-ant-xxx claude-3-7-sonnet
+```
+
+- In the Web UI, each Claude configuration card now has a "Share Import Command" button that copies a one-click import command (for example: `codexmate claude <BaseURL> <API Key> <Model>`).
 
 ### OpenClaw Config Mode
 
@@ -243,43 +251,43 @@ 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
-```
-
-### 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`
+### 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 run`
 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`
 6. Restart Claude Code to apply
 
-### 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.
+### Start the Web UI
+
+```bash
+codexmate run
+```
+
+By default it binds to `127.0.0.1`. To expose on LAN, use `--host` or `CODEXMATE_HOST`:
+
+```bash
+codexmate run --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
 

package/README.zh-CN.md

@@ -49,7 +49,7 @@ Codex Mate 让 Codex 与 Claude Code 的提供商/模型切换变成“一条命
 
 - 只做 Codex、Claude Code 与 OpenClaw 的配置管理，不做全量多工具一体化
 - 不内置代理/转发/费用面板/云同步（保持轻量）
-- Web UI 仅在你启动时运行（`codexmate start`）
+- Web UI 仅在你启动时运行（`codexmate run`）
 
 ## 30 秒上手（免安装）
 
@@ -58,7 +58,7 @@ npx codexmate@latest status
 ```
 
 ```bash
-npx codexmate@latest start
+npx codexmate@latest run
 ```
 
 然后在浏览器中打开 `http://localhost:3737`。
@@ -87,7 +87,7 @@ codexmate status
 
 4. 启动 Web 界面：
 ```bash
-codexmate start
+codexmate run
 ```
 
 然后在浏览器中打开 `http://localhost:3737`。
@@ -123,7 +123,7 @@ npx codexmate@latest status
 ```
 
 ```bash
-npx codexmate@latest start
+npx codexmate@latest run
 ```
 
 ### 从源码安装
@@ -152,18 +152,19 @@ npm link
 | `codexmate use <模型名称>` | 切换模型 |
 | `codexmate add <名称> <URL> [API密钥]` | 添加新提供商 |
 | `codexmate delete <提供商名称>` | 删除提供商 |
+| `codexmate claude <BaseURL> <API密钥> [模型]` | 一键写入 Claude Code 配置到 `~/.claude/settings.json` |
 | `codexmate models` | 列出所有模型 |
-| `codexmate add-model <模型名称>` | 添加模型 |
-| `codexmate delete-model <模型名称>` | 删除模型 |
-| `codexmate start` | 启动 Web 界面 |
-| `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | 导出指定会话为 Markdown |
+| `codexmate add-model <模型名称>` | 添加模型 |
+| `codexmate delete-model <模型名称>` | 删除模型 |
+| `codexmate run` | 启动 Web 界面 |
+| `codexmate export-session --source <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]` | 导出指定会话为 Markdown |
 
 ## Web 界面
 
 启动 Web 界面（自动打开浏览器）：
 
 ```bash
-codexmate start
+codexmate run
 ```
 
 ### Codex 配置模式
@@ -180,6 +181,13 @@ codexmate start
 - 管理多个 Claude Code 配置方案
 - 配置 API Key、Base URL 和模型
 - 默认写入 `~/.claude/settings.json` 的 `env` 字段：`env.ANTHROPIC_API_KEY` / `env.ANTHROPIC_BASE_URL` / `env.ANTHROPIC_MODEL`
+- CLI 一行应用示例：
+
+```bash
+codexmate claude https://api.example.com/v1 sk-ant-xxx claude-3-7-sonnet
+```
+
+- Web 界面中每个 Claude 配置卡片新增“分享导入命令”按钮，可复制一条 `codexmate claude <BaseURL> <API Key> <模型>` 命令便于分享。
 
 ### OpenClaw 配置模式
 
@@ -243,43 +251,43 @@ codexmate add myapi https://api.example.com/v1 sk-your-api-key
 codexmate switch myapi
 ```
 
-### 切换到不同的模型
-
-```bash
-codexmate use gpt-4-turbo
-```
-
-### 导出会话（CLI）
-
-```bash
-codexmate export-session --source codex --session-id 123456
-codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl" --max-messages=all
-```
-
-默认最多导出 1000 条消息；如需完整导出可用 `--max-messages=all`（或 `Infinity`）。
-
-### 配置 Claude Code（跨平台）
-
-1. 启动 Web 界面：`codexmate start`
+### 切换到不同的模型
+
+```bash
+codexmate use gpt-4-turbo
+```
+
+### 导出会话（CLI）
+
+```bash
+codexmate export-session --source codex --session-id 123456
+codexmate export-session --source claude --file "~/.claude/projects/demo/session.jsonl" --max-messages=all
+```
+
+默认最多导出 1000 条消息；如需完整导出可用 `--max-messages=all`（或 `Infinity`）。
+
+### 配置 Claude Code（跨平台）
+
+1. 启动 Web 界面：`codexmate run`
 2. 在浏览器中切换到 "Claude Code 配置" 模式
 3. 添加配置方案（例如智谱 GLM）：配置名称=智谱GLM，API Key=你的 API Key，Base URL=`https://open.bigmodel.cn/api/anthropic`，模型=`glm-4.7`
 4. 点击配置卡片直接应用，或在编辑弹窗点击“保存并应用到 Claude 配置”
 5. 默认写入 `~/.claude/settings.json`
 6. 重启 Claude Code，新的配置即生效
 
-### 启动 Web 界面
-
-```bash
-codexmate start
-```
-
-默认仅监听 `127.0.0.1`。如需局域网访问，可用 `--host` 或 `CODEXMATE_HOST`：
-
-```bash
-codexmate start --host 0.0.0.0
-```
-
-然后在浏览器中打开 `http://localhost:3737`（或你指定的地址）。注意：监听 `0.0.0.0` 在不可信网络下不安全。
+### 启动 Web 界面
+
+```bash
+codexmate run
+```
+
+默认仅监听 `127.0.0.1`。如需局域网访问，可用 `--host` 或 `CODEXMATE_HOST`：
+
+```bash
+codexmate run --host 0.0.0.0
+```
+
+然后在浏览器中打开 `http://localhost:3737`（或你指定的地址）。注意：监听 `0.0.0.0` 在不可信网络下不安全。
 
 ## 常见问题