codexmate 0.0.48 → 0.0.50

package/README.md

@@ -58,6 +58,7 @@ Unlike simple wrappers, Codex Mate acts as a **Local Agent Bridge**:
 - **Claude Provider Bridge**: Connect Claude Code to OpenAI Chat Completions-compatible providers and Ollama through the built-in local Claude-compatible proxy.
 - **OpenCode Provider Control**: Manage OpenCode provider/model selection with a CodexMate-owned provider store under `~/.codexmate`, projecting only the active provider into native OpenCode config to avoid polluting or deleting user-owned settings.
 - **Skills Marketplace**: A local-first market to share and import skills between different agent apps.
+- **Prompt File Editor**: Unified editor for global and project-level `CLAUDE.md` and `AGENTS.md` with auto-detection of project paths.
 - **Task Orchestrator**: Plan and execute complex tasks with dependency tracking.
 
 ---
@@ -76,6 +77,7 @@ Unlike simple wrappers, Codex Mate acts as a **Local Agent Bridge**:
 | **Claude Provider Bridge** | ✅ | Connect Claude Code to OpenAI Chat Completions-compatible providers and Ollama via the built-in Claude-compatible proxy |
 | **OpenCode Provider Store** | ✅ | Keep multiple OpenCode providers in `~/.codexmate` while projecting only the selected provider to native OpenCode config |
 | **Prompt Templates** | ✅ | Reusable prompt plugins with variables |
+| **Prompt File Editor** | ✅ | Edit global and project-level CLAUDE.md / AGENTS.md with auto-detect and path switching |
 | **MCP Integration** | ✅ | Expose local tools and resources via MCP stdio |
 | **Auto Update** | ✅ | Quick update CLI via `codexmate update` |
 

package/README.zh.md

@@ -58,6 +58,7 @@
 - **Claude Provider 桥接**：通过内建本地 Claude 兼容代理，让 Claude Code 接入 OpenAI Chat Completions 兼容 provider 与 Ollama。
 - **OpenCode Provider 控制**：在 `~/.codexmate` 下维护 CodexMate 自有的 OpenCode 多 provider 存储，只将当前选中的 provider 投影到 OpenCode 原生配置，避免污染或误删用户已有配置。
 - **Skills 市场**：本地优先的市场，支持在不同的智能体应用之间共享和导入 Skills。
+- **提示词文件编辑器**：统一编辑全局和项目级 `CLAUDE.md` 与 `AGENTS.md`，支持项目路径自动检测。
 - **任务编排器**：支持带有依赖跟踪的复杂任务规划与执行。
 
 ---
@@ -76,6 +77,7 @@
 | **Claude Provider 桥接** | ✅ | 通过内建 Claude 兼容代理，让 Claude Code 接入 OpenAI Chat Completions 兼容 provider 与 Ollama |
 | **OpenCode Provider 存储** | ✅ | 在 `~/.codexmate` 中保留多个 OpenCode provider，只将当前选中的 provider 投影到 OpenCode 原生配置 |
 | **提示词模板** | ✅ | 支持变量的可复用提示词插件 |
+| **提示词文件编辑器** | ✅ | 编辑全局和项目级 CLAUDE.md / AGENTS.md，支持自动检测与路径切换 |
 | **MCP 集成** | ✅ | 通过 MCP stdio 暴露本地工具与资源 |
 | **自动更新** | ✅ | 通过 `codexmate update` 快速更新 CLI |
 

package/cli/agents-files.js

@@ -53,57 +53,119 @@ function createAgentsFileController(deps = {}) {
         return { ok: true, dirPath };
     }
 
-    function resolveClaudeMdFilePath() {
-        return path.join(CLAUDE_DIR, CLAUDE_MD_FILE_NAME);
+    function detectProjectClaudeMdDir(baseDir) {
+        if (typeof baseDir !== 'string' || !baseDir.trim()) {
+            return { error: 'project path is required' };
+        }
+        const root = baseDir.trim();
+        const rootPath = path.join(root, CLAUDE_MD_FILE_NAME);
+        const dotDirPath = path.join(root, '.claude', CLAUDE_MD_FILE_NAME);
+        try {
+            if (fs.statSync(rootPath).isFile()) {
+                return { path: rootPath, source: 'root', dir: root };
+            }
+        } catch (_) {}
+        try {
+            if (fs.statSync(dotDirPath).isFile()) {
+                return { path: dotDirPath, source: 'dotdir', dir: path.join(root, '.claude') };
+            }
+        } catch (_) {}
+        return { path: rootPath, source: 'root', dir: root };
+    }
+
+    function validateClaudeMdBaseDir(filePath) {
+        const dirPath = path.dirname(filePath);
+        try {
+            const stat = fs.statSync(dirPath);
+            if (!stat.isDirectory()) {
+                return { error: 'project directory is not a directory: ' + dirPath };
+            }
+        } catch (e) {
+            return { error: 'project directory does not exist: ' + dirPath };
+        }
+        return { ok: true, dirPath };
+    }
+
+    function resolveClaudeMdFilePath(params = {}) {
+        const baseDir = typeof params.baseDir === 'string' && params.baseDir.trim()
+            ? params.baseDir.trim()
+            : '';
+        if (!baseDir) {
+            return { filePath: path.join(CLAUDE_DIR, CLAUDE_MD_FILE_NAME), isProject: false };
+        }
+        var detected = detectProjectClaudeMdDir(baseDir);
+        if (detected.error) {
+            return { filePath: path.join(CLAUDE_DIR, CLAUDE_MD_FILE_NAME), isProject: false, detectionError: detected.error };
+        }
+        return { filePath: detected.path, isProject: true, detectionSource: detected.source, projectPath: baseDir };
     }
 
     function readClaudeMdFile(params = {}) {
-        const filePath = resolveClaudeMdFilePath();
-        const lineEndingFallback = os.EOL === '\r\n' ? '\r\n' : '\n';
+        var resolved = resolveClaudeMdFilePath(params);
+        var filePath = resolved.filePath;
+        var lineEndingFallback = os.EOL === '\r\n' ? '\r\n' : '\n';
+        var base = {
+            path: filePath,
+            lineEnding: lineEndingFallback
+        };
+        if (resolved.isProject) {
+            base.detectionSource = resolved.detectionSource;
+            base.projectPath = resolved.projectPath;
+        }
+        if (resolved.detectionError) {
+            base.detectionError = resolved.detectionError;
+        }
+        if (resolved.isProject) {
+            var dirCheck = validateClaudeMdBaseDir(filePath);
+            if (dirCheck.error) {
+                return { error: dirCheck.error };
+            }
+        }
         if (!fs.existsSync(filePath)) {
-            return {
-                exists: false,
-                path: filePath,
-                content: '',
-                lineEnding: lineEndingFallback
-            };
+            return Object.assign({ exists: false, content: '' }, base);
         }
         if (params.metaOnly) {
-            return {
-                exists: true,
-                path: filePath,
-                content: '',
-                lineEnding: lineEndingFallback
-            };
+            return Object.assign({ exists: true, content: '' }, base);
         }
         try {
-            const raw = fs.readFileSync(filePath, 'utf-8');
-            return {
+            var raw = fs.readFileSync(filePath, 'utf-8');
+            var result = {
                 exists: true,
                 path: filePath,
                 content: stripUtf8Bom(raw),
                 lineEnding: detectLineEnding(raw)
             };
+            if (resolved.isProject) {
+                result.detectionSource = resolved.detectionSource;
+                result.projectPath = resolved.projectPath;
+            }
+            return result;
         } catch (e) {
-            return { error: `读取 CLAUDE.md 失败: ${e.message}` };
+            return { error: 'read CLAUDE.md failed: ' + e.message };
         }
     }
 
     function applyClaudeMdFile(params = {}) {
-        const filePath = resolveClaudeMdFilePath();
-        const content = typeof params.content === 'string' ? params.content : '';
+        var resolved = resolveClaudeMdFilePath(params);
+        var filePath = resolved.filePath;
+        var content = typeof params.content === 'string' ? params.content : '';
         if (content.length > 2 * 1024 * 1024) {
-            return { error: '内容过大（最大 2MB）' };
+            return { error: 'content too large (max 2MB)' };
         }
-        const lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
-        const normalized = normalizeLineEnding(content, lineEnding);
-        const finalContent = ensureUtf8Bom(normalized);
+        var lineEnding = params.lineEnding === '\r\n' ? '\r\n' : '\n';
+        var normalized = normalizeLineEnding(content, lineEnding);
+        var finalContent = ensureUtf8Bom(normalized);
         try {
-            ensureDir(CLAUDE_DIR);
+            ensureDir(path.dirname(filePath));
             fs.writeFileSync(filePath, finalContent, 'utf-8');
-            return { success: true, path: filePath };
+            var result = { success: true, path: filePath };
+            if (resolved.isProject) {
+                result.projectPath = resolved.projectPath;
+                result.detectionSource = resolved.detectionSource;
+            }
+            return result;
         } catch (e) {
-            return { error: `写入 CLAUDE.md 失败: ${e.message}` };
+            return { error: 'write CLAUDE.md failed: ' + e.message };
         }
     }
 
@@ -181,6 +243,11 @@ function createAgentsFileController(deps = {}) {
         let readResult;
         if (context === 'claude-md') {
             readResult = readClaudeMdFile({ metaOnly });
+        } else if (context === 'claude-project') {
+            if (!params.baseDir || !String(params.baseDir).trim()) {
+                return { error: 'project path is required for claude-project context' };
+            }
+            readResult = readClaudeMdFile({ ...params, metaOnly });
         } else if (context === 'openclaw') {
             readResult = readOpenclawAgentsFile({ metaOnly });
         } else if (context === 'openclaw-workspace') {
@@ -215,6 +282,8 @@ function createAgentsFileController(deps = {}) {
     return {
         resolveAgentsFilePath,
         validateAgentsBaseDir,
+        detectProjectClaudeMdDir,
+        validateClaudeMdBaseDir,
         resolveClaudeMdFilePath,
         readClaudeMdFile,
         applyClaudeMdFile,

package/cli.js

@@ -1828,6 +1828,8 @@ async function fetchProviderModels(providerName, overrides = {}) {
 const {
     resolveAgentsFilePath,
     validateAgentsBaseDir,
+    detectProjectClaudeMdDir,
+    validateClaudeMdBaseDir,
     resolveClaudeMdFilePath,
     readClaudeMdFile,
     applyClaudeMdFile,
@@ -11876,10 +11878,16 @@ function createWebServer({ htmlPath, assetsDir, webDir, host, port, openBrowser
                         case 'apply-claude-md-file':
                             result = applyClaudeMdFile(params || {});
                             if (result && !result.error) {
-                                const mdTarget = (params && params.targetPath) ? String(params.targetPath) : 'CLAUDE.md';
-                                notifyWebhook('claude-md-edit', 'CLAUDE.md modified: ' + mdTarget, { targetPath: mdTarget }).catch(function () { });
+                                const mdBaseDir = params && params.baseDir ? String(params.baseDir).trim() : '';
+                                const mdTarget = mdBaseDir
+                                    ? path.join(mdBaseDir, 'CLAUDE.md')
+                                    : ((params && params.targetPath) ? String(params.targetPath) : 'CLAUDE.md');
+                                notifyWebhook('claude-md-edit', 'CLAUDE.md modified: ' + mdTarget, { targetPath: mdTarget, projectPath: mdBaseDir }).catch(function () { });
                             }
                             break;
+                        case 'detect-project-claude-md':
+                            result = detectProjectClaudeMdDir((params && params.baseDir) || '');
+                            break;
                         case 'preview-agents-diff':
                             result = buildAgentsDiff(params || {});
                             break;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexmate",
-  "version": "0.0.48",
+  "version": "0.0.50",
   "description": "Codex/Claude Code/OpenClaw 配置、会话与任务编排 CLI + Web 工具",
   "main": "cli.js",
   "bin": {
@@ -10,6 +10,7 @@
     "cli.js",
     "cli/",
     "plugins/",
+    "skills/",
     "web-ui.html",
     "lib/",
     "web-ui/",

package/skills/codexmate-project-context-recovery/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: codexmate-project-context-recovery
+description: Recovers project handoff context from local Codex, Claude Code, Gemini, CodeBuddy, and codexmate-derived sessions. Use when the user asks what happened in prior project/PR/branch/file/error work, needs a handoff brief, wants old decisions or validations recovered, or asks to summarize cross-session project activity with evidence.
+---
+
+# Codexmate Project Context Recovery
+
+## Overview
+
+Use this skill to build an evidence-first project handoff brief from local agent sessions. It is not semantic memory or a live GitHub source of truth. It works best with hard identifiers: `owner/repo`, branch names, file paths, commit hashes, exact errors, PR/issue numbers plus repo filters, or unique commands.
+
+Old sessions are historical evidence. Mutable facts such as PR state, CI, releases, deployments, and current files still require live checks before action.
+
+## Quick Start
+
+Generate a context brief first. Resolve `scripts/search_sessions.py` relative to this skill directory; after npm installation the full package path is `node_modules/codexmate/skills/codexmate-project-context-recovery/scripts/search_sessions.py`.
+
+```bash
+python3 scripts/search_sessions.py "SakuraByteCore/codexmate feat/task-orchestration-tab" --mode brief --source all --path-filter codexmate --match all --format text --limit 8
+```
+
+Use plain search when you need raw candidates:
+
+```bash
+python3 scripts/search_sessions.py "exact error text" --mode search --source all --path-filter codexmate --format text --limit 10
+```
+
+## Workflow
+
+1. **Confirm the object**: repo/project, PR/issue number, branch, file path, command, exact error text, person, or date range. If multiple projects match, state the chosen object before searching.
+2. **Prefer hard identifiers**: exact `owner/repo`, short repo name, PR/issue number with repo filter, branch, file path, commit hash, exact error, then user wording.
+3. **Generate a brief**: use `--mode brief`; add `--path-filter` for project/worktree isolation; use `--match all` when the query has strong identifiers.
+4. **Check confidence**: `high` means multiple hard signals appeared; `medium/weak` means re-query with stronger identifiers before relying on it; `none` means no hits were found.
+5. **Use the brief as a handoff**: extract timeline, decisions, validations, risks, files, commands, commits, and top evidence sessions.
+6. **Live-check mutable facts**: before commenting, merging, releasing, or claiming current status, check GitHub/current files directly.
+
+## What Good Output Looks Like
+
+- **Target Object:** repo / PR / branch / file / error
+- **Context Brief:** confidence, top sources, timeline, repos/branches/PRs/files
+- **Historical Evidence:** session source/id/path + snippets
+- **Handoff Summary:** decisions, validations, risks, commands, commits
+- **Live Verification:** PR/check/review/release/current-file facts that still need live verification
+
+## Optional codexmate MCP Path
+
+If codexmate MCP is configured and healthy, use it to inspect strong candidates:
+
+- `codexmate.session.list` with `source`, `query`, `queryScope: "all"`, `limit`, and `forceRefresh: true`.
+- `codexmate.session.detail` for candidate session inspection.
+- `codexmate.session.export` only when a markdown export is useful.
+
+If MCP is unavailable, do not block; run `scripts/search_sessions.py`.
+
+## Limits
+
+- Generic natural-language queries can be noisy.
+- Short PR numbers without repo/path filters are weak signals.
+- Session logs may contain stale, failed, or speculative work.
+- The brief should guide investigation; it must not replace current repo/GitHub verification.
+
+## Privacy
+
+Share only context relevant to the current task. Do not quote credentials, unrelated personal details, private memory, or large transcript chunks. In group chats, summarize narrowly and avoid exposing unrelated sessions.