codexmate 0.0.30 → 0.0.31

package/README.md

@@ -6,9 +6,11 @@
 
 **One dashboard for all your local AI coding tools — switch providers, manage sessions, edit configs, and orchestrate tasks across Codex, Claude Code, and OpenClaw. Built-in OpenAI-compatible bridge, usage analytics, and prompt templates. Zero cloud, zero setup.**
 
-[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?label=build&style=flat)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
 [![Version](https://img.shields.io/npm/v/codexmate?label=version&style=flat)](https://www.npmjs.com/package/codexmate)
+[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?label=build&style=flat)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
 [![Downloads](https://img.shields.io/npm/dt/codexmate?label=downloads&style=flat)](https://www.npmjs.com/package/codexmate)
+[![Install](https://img.shields.io/badge/install-curl%20%7C%20npm-0A0?style=flat)](#install-via-curl-standalone)
+[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20macOS%20%7C%20Windows-555?style=flat)](#quick-start)
 [![Node](https://img.shields.io/node/v/codexmate?label=Node.js&style=flat&logo=node.js&logoColor=white)](https://nodejs.org/)
 [![License](https://img.shields.io/npm/l/codexmate?label=license&style=flat)](LICENSE)
 [![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?label=stars&style=flat)](https://github.com/SakuraByteCore/codexmate/stargazers)
@@ -175,6 +177,21 @@ Default listen address is `0.0.0.0:3737` for LAN access, and browser auto-open i
 
 > Safety note: the unauthenticated management UI is exposed to your current LAN by default. Use trusted networks only; for local-only access, set `CODEXMATE_HOST=127.0.0.1` or pass `--host 127.0.0.1`.
 
+### Install via curl (standalone)
+
+No npm required. Downloads a self-contained tarball with `node_modules` bundled:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash
+```
+
+Installs to `~/.codexmate`, symlinks to `~/.local/bin/codexmate`, and auto-adds PATH.
+
+| Variable | Default | Description |
+| --- | --- | --- |
+| `CODEXMATE_INSTALL_DIR` | `~/.codexmate` | Installation directory |
+| `CODEXMATE_BIN_DIR` | `~/.local/bin` | Symlink directory |
+
 ### Install Codex CLI / Claude Code CLI (optional)
 
 Codex Mate can pass through to the official CLIs (e.g. `codexmate codex ...`). Install them first:
@@ -344,78 +361,3 @@ Issues and pull requests are accepted.
 ## License
 
 Apache-2.0
-
-### Claude Code Mode
-- Multi-profile management
-- Default write to `~/.claude/settings.json`
-- `~/.claude/CLAUDE.md` editing
-- Shareable import command copy
-
-### OpenClaw Mode
-- JSON5 multi-profile management
-- Apply to `~/.openclaw/openclaw.json`
-- Manage `~/.openclaw/workspace/AGENTS.md`
-
-### Sessions Mode
-- Unified Codex + Claude sessions
-- Browser / Usage subview switching
-- Local pin/unpin with persistent storage and pinned-first ordering
-- Search, filter, export, delete, batch cleanup
-- Usage view includes 7d / 30d session trends, message trends, source share, and top paths
-
-### Skills Market Tab
-- Switch the skills install target between `Codex` and `Claude Code`
-- Show the current local skills root, installed items, and importable items
-- Scan importable sources under `Codex` / `Claude Code` / `Agents`
-- Support cross-app import, ZIP import/export, and batch delete
-
-## MCP
-
-> Transport: `stdio`
-
-- Default: read-only tools
-- Enable writes: `--allow-write` or `CODEXMATE_MCP_ALLOW_WRITE=1`
-- Domains: `tools`, `resources`, `prompts`
-
-Examples:
-
-```bash
-codexmate mcp serve --read-only
-codexmate mcp serve --allow-write
-```
-
-## Config Files
-
-- `~/.codex/config.toml`
-- `~/.codex/auth.json`
-- `~/.codex/models.json`
-- `~/.codex/provider-current-models.json`
-- `~/.claude/settings.json`
-- `~/.claude/CLAUDE.md`
-- `~/.openclaw/openclaw.json`
-- `~/.openclaw/workspace/AGENTS.md`
-
-## Environment Variables
-
-| Variable | Default | Description |
-| --- | --- | --- |
-| `CODEXMATE_PORT` | `3737` | Web server port |
-| `CODEXMATE_HOST` | `0.0.0.0` | Web listen host (set `127.0.0.1` for local-only access) |
-| `CODEXMATE_NO_BROWSER` | unset | Set `1` to disable browser auto-open |
-| `CODEXMATE_MCP_ALLOW_WRITE` | unset | Set `1` to allow MCP write tools by default |
-| `CODEXMATE_FORCE_RESET_EXISTING_CONFIG` | `0` | Set `1` to force bootstrap reset of existing config |
-
-## Tech Stack
-
-- Node.js
-- Vue.js 3 (Web UI)
-- Native HTTP server
-- `@iarna/toml`, `json5`
-
-## Contributing
-
-Issues and pull requests are accepted.
-
-## License
-
-Apache-2.0

package/README.zh.md

@@ -6,9 +6,11 @@
 
 **一个面板管好所有本地 AI 编码工具 — 跨 Codex / Claude Code / OpenClaw 切 provider、管会话、改配置、编排任务。内置 OpenAI 兼容桥接、Usage 统计与提示词模板。纯本地，零上云。**
 
-[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?label=build&style=flat)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
 [![Version](https://img.shields.io/npm/v/codexmate?label=version&style=flat)](https://www.npmjs.com/package/codexmate)
+[![Build](https://img.shields.io/github/actions/workflow/status/SakuraByteCore/codexmate/release.yml?label=build&style=flat)](https://github.com/SakuraByteCore/codexmate/actions/workflows/release.yml)
 [![Downloads](https://img.shields.io/npm/dt/codexmate?label=downloads&style=flat)](https://www.npmjs.com/package/codexmate)
+[![Install](https://img.shields.io/badge/install-curl%20%7C%20npm-0A0?style=flat)](#curl-一键安装独立包无需-npm)
+[![Platform](https://img.shields.io/badge/platform-Termux%20%7C%20Linux%20%7C%20macOS%20%7C%20Windows-555?style=flat)](#快速开始)
 [![Node](https://img.shields.io/node/v/codexmate?label=Node.js&style=flat&logo=node.js&logoColor=white)](https://nodejs.org/)
 [![License](https://img.shields.io/npm/l/codexmate?label=license&style=flat)](LICENSE)
 [![Stars](https://img.shields.io/github/stars/SakuraByteCore/codexmate?label=stars&style=flat)](https://github.com/SakuraByteCore/codexmate/stargazers)
@@ -178,6 +180,21 @@ codexmate run
 
 > 安全提示：默认监听会在当前局域网暴露未鉴权的管理界面。若包含 API Key、provider 配置或 skills 管理，请仅在可信网络中使用；如需仅本机访问，可设置 `CODEXMATE_HOST=127.0.0.1` 或启动时传入 `--host 127.0.0.1`。
 
+### curl 一键安装（独立包，无需 npm）
+
+下载包含 `node_modules` 的自包含安装包，不依赖 npm：
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/SakuraByteCore/codexmate/main/scripts/install.sh | bash
+```
+
+安装到 `~/.codexmate`，自动软链接到 `~/.local/bin/codexmate`，并添加 PATH。
+
+| 变量 | 默认值 | 说明 |
+| --- | --- | --- |
+| `CODEXMATE_INSTALL_DIR` | `~/.codexmate` | 安装目录 |
+| `CODEXMATE_BIN_DIR` | `~/.local/bin` | 软链接目录 |
+
 ### 安装 Codex CLI / Claude Code / Gemini CLI / CodeBuddy Code（可选）
 
 Codex Mate 支持透传调用官方 CLI（例如 `codexmate codex ...`），建议先安装：

package/cli/session-convert-args.js

@@ -25,7 +25,7 @@ function resolveOutputPath(outputPath, defaultFileName) {
 }
 
 function parseArgs(args = []) {
-    const options = { from: '', to: '', sessionId: '', filePath: '', output: '', maxMessages: undefined };
+    const options = { from: '', to: '', sessionId: '', filePath: '', output: '', outputDir: 'native', maxMessages: undefined };
     const errors = [];
     for (let i = 0; i < args.length; i += 1) {
         const arg = String(args[i] || '');
@@ -41,6 +41,8 @@ function parseArgs(args = []) {
         if (arg.startsWith('--file=')) { options.filePath = arg.slice(7); continue; }
         if (arg === '--output') { options.output = next; i += 1; continue; }
         if (arg.startsWith('--output=')) { options.output = arg.slice(9); continue; }
+        if (arg === '--output-dir') { options.outputDir = next; i += 1; continue; }
+        if (arg.startsWith('--output-dir=')) { options.outputDir = arg.slice(13); continue; }
         if (arg === '--max-messages') { options.maxMessages = next; i += 1; continue; }
         if (arg.startsWith('--max-messages=')) { options.maxMessages = arg.slice(15); continue; }
         errors.push(`未知参数: ${arg}`);
@@ -50,6 +52,8 @@ function parseArgs(args = []) {
     if (options.from !== 'codex' && options.from !== 'claude') errors.push('参数 --from 仅支持 codex 或 claude');
     if (options.to !== 'codex' && options.to !== 'claude') errors.push('参数 --to 仅支持 codex 或 claude');
     if (options.from && options.to && options.from === options.to) errors.push('--from 与 --to 不能相同');
+    options.outputDir = String(options.outputDir || 'native').trim().toLowerCase();
+    if (options.outputDir !== 'native' && options.outputDir !== 'derived') errors.push('参数 --output-dir 仅支持 native 或 derived');
     if (!options.from) errors.push('缺少 --from');
     if (!options.to) errors.push('缺少 --to');
     if (!options.sessionId && !options.filePath) errors.push('必须指定 --session-id 或 --file');

package/cli/session-convert.js

@@ -6,7 +6,80 @@ const { readSessionMessages, buildTargetRecords } = require('./session-convert-i
 
 function printUsage() {
     console.log('\n用法:');
-    console.log('  codexmate convert-session --from <codex|claude> --to <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--max-messages <N|all|Infinity>]');
+    console.log('  codexmate convert-session --from <codex|claude> --to <codex|claude> (--session-id <ID>|--file <PATH>) [--output <PATH>] [--output-dir <native|derived>] [--max-messages <N|all|Infinity>]');
+}
+
+
+function resolveExistingDir(candidates, fallback) {
+    for (const candidate of candidates) {
+        if (!candidate) continue;
+        try {
+            if (fs.existsSync(candidate) && fs.statSync(candidate).isDirectory()) return candidate;
+        } catch (_) {}
+    }
+    return fallback;
+}
+
+function resolveCodexSessionsDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const candidates = [];
+    if (process.env.CODEX_HOME) candidates.push(path.join(process.env.CODEX_HOME, 'sessions'));
+    if (process.env.XDG_CONFIG_HOME) candidates.push(path.join(process.env.XDG_CONFIG_HOME, 'codex', 'sessions'));
+    if (home) {
+        candidates.push(path.join(home, '.config', 'codex', 'sessions'));
+        candidates.push(path.join(home, '.codex', 'sessions'));
+    }
+    return resolveExistingDir(candidates, candidates[candidates.length - 1] || path.resolve('.codex/sessions'));
+}
+
+function resolveClaudeProjectsDir() {
+    const home = process.env.HOME || process.env.USERPROFILE || '';
+    const candidates = [];
+    const claudeHome = process.env.CLAUDE_HOME || process.env.CLAUDE_CONFIG_DIR || '';
+    if (claudeHome) candidates.push(path.join(claudeHome, 'projects'));
+    if (process.env.XDG_CONFIG_HOME) candidates.push(path.join(process.env.XDG_CONFIG_HOME, 'claude', 'projects'));
+    if (home) {
+        candidates.push(path.join(home, '.config', 'claude', 'projects'));
+        candidates.push(path.join(home, '.claude', 'projects'));
+    }
+    return resolveExistingDir(candidates, candidates[candidates.length - 1] || path.resolve('.claude/projects'));
+}
+
+function sanitizeClaudeProjectName(cwd) {
+    const value = typeof cwd === 'string' && cwd.trim() ? path.resolve(cwd.trim()) : 'codexmate-derived';
+    return value.replace(/[^a-zA-Z0-9._-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '') || 'codexmate-derived';
+}
+
+function buildSourceKey(from, sessionId, filePath) {
+    const seed = `${from}|${sessionId || ''}|${filePath || ''}`;
+    let hash = 0;
+    for (let i = 0; i < seed.length; i += 1) hash = ((hash << 5) - hash + seed.charCodeAt(i)) | 0;
+    return String(Math.abs(hash)).padStart(8, '0').slice(0, 8);
+}
+
+function resolveDefaultOutputPath(opt, sessionId, cwd) {
+    const safeSessionId = String(sessionId).replace(/[^a-zA-Z0-9_-]/g, '_') || 'session';
+    if (opt.output) return resolveOutputPath(opt.output, `${opt.to}-session-${safeSessionId}.jsonl`);
+    if (opt.outputDir === 'derived') {
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        const root = path.join(home || process.cwd(), '.codexmate', 'sessions', 'derived', opt.to, opt.from, buildSourceKey(opt.from, sessionId, opt.filePath));
+        return path.join(root, `${safeSessionId}.jsonl`);
+    }
+    if (opt.to === 'codex') return path.join(resolveCodexSessionsDir(), `${safeSessionId}.jsonl`);
+    return path.join(resolveClaudeProjectsDir(), sanitizeClaudeProjectName(cwd), `${safeSessionId}.jsonl`);
+}
+
+function getDerivedSessionMetaPath(filePath) {
+    if (!filePath) return '';
+    return filePath.toLowerCase().endsWith('.jsonl')
+        ? filePath.slice(0, -6) + '.meta.json'
+        : `${filePath}.meta.json`;
+}
+
+function writeJsonAtomic(filePath, value) {
+    const tmpPath = `${filePath}.tmp-${process.pid}-${Date.now()}`;
+    fs.writeFileSync(tmpPath, `${JSON.stringify(value, null, 2)}\n`, { encoding: 'utf-8', flag: 'wx' });
+    fs.renameSync(tmpPath, filePath);
 }
 
 async function cmdConvertSession(args = [], deps = {}) {
@@ -28,12 +101,46 @@ async function cmdConvertSession(args = [], deps = {}) {
     }
     const extracted = await readSessionMessages(filePath, opt.from, opt.maxMessages);
     const sessionId = extracted.sessionId || opt.sessionId || path.basename(filePath, '.jsonl');
-    const safeSessionId = String(sessionId).replace(/[^a-zA-Z0-9_-]/g, '_');
     const records = buildTargetRecords(opt.to, { sessionId, cwd: extracted.cwd || '', messages: extracted.messages });
     const jsonl = `${records.map(r => JSON.stringify(r)).join('\n')}\n`;
-    const outputPath = resolveOutputPath(opt.output, `${opt.to}-session-${safeSessionId}.jsonl`);
+    const outputPath = resolveDefaultOutputPath(opt, sessionId, extracted.cwd || '');
+    const metaPath = getDerivedSessionMetaPath(outputPath);
     ensureDir(path.dirname(outputPath));
-    fs.writeFileSync(outputPath, jsonl, 'utf-8');
+    try {
+        if (fs.existsSync(metaPath)) {
+            const error = new Error(`target session metadata already exists: ${metaPath}`);
+            error.code = 'EEXIST';
+            throw error;
+        }
+        fs.writeFileSync(outputPath, jsonl, { encoding: 'utf-8', flag: 'wx' });
+        writeJsonAtomic(metaPath, {
+            version: 1,
+            createdAt: new Date().toISOString(),
+            source: {
+                type: opt.from,
+                sessionId,
+                filePath
+            },
+            target: {
+                type: opt.to,
+                sessionId,
+                filePath: outputPath
+            },
+            options: {
+                maxMessages: opt.maxMessages,
+                outputDir: opt.outputDir
+            }
+        });
+    } catch (error) {
+        if (error && error.code === 'EEXIST') {
+            console.error('转换失败: target session already exists:', outputPath);
+            process.exit(1);
+        }
+        try {
+            if (fs.existsSync(outputPath) && !fs.existsSync(metaPath)) fs.unlinkSync(outputPath);
+        } catch (_) {}
+        throw error;
+    }
     console.log('\n✓ 会话已转换:', outputPath);
     if (extracted.truncated) console.log('! 已截断: 可使用 --max-messages=all');
     console.log();