claude-runtime-sync 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stringzhao
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,95 @@
+# claude-runtime-sync
+
+Use Claude config (`~/.claude` + `<repo>/.claude`) as the **single source of truth**, and sync reusable runtime capabilities into Codex.
+
+## Features
+
+- Sync skills from Claude to Codex
+- Sync MCP servers into managed block of `~/.codex/config.toml`
+- Mirror project `.mcp.json` into `~/.claude/mcp.json`
+- Sync Claude plugins and hooks metadata into Codex runtime area
+- Generate bridge manifest for Codex event -> Claude hooks mapping
+- Keep `agents.md` / `gemini.md` aligned with `CLAUDE.md` (symlink-first)
+- Install zsh startup hook for auto-check + auto-sync before each `codex` launch
+
+## Install
+
+```bash
+npm i -g claude-runtime-sync
+```
+
+## CLI
+
+```bash
+crs sync
+crs check
+crs bridge --watch
+crs hook install
+crs hook remove
+crs sync-base
+```
+
+## Common flags
+
+```bash
+--project-root=/path/to/repo
+--claude-home=/path/to/.claude
+--codex-home=/path/to/.codex
+--no-home
+--no-project
+```
+
+## Recommended bootstrap
+
+```bash
+# 1) one-time hook install
+crs hook install
+
+# 2) verify drift state
+crs check
+
+# 3) apply sync if needed
+crs sync
+```
+
+## Local development
+
+```bash
+npm run check
+npm run smoke
+npm run pack:dry-run
+```
+
+## GitHub Actions
+
+This repo includes:
+
+- `.github/workflows/ci.yml`: syntax check + CLI smoke + pack dry run
+- `.github/workflows/publish.yml`: publish to npm on `v*` tag or manual dispatch
+
+Required repository secret:
+
+- `NPM_TOKEN`: npm automation token with publish permission
+
+## Publish flow
+
+```bash
+# bump version first
+npm version patch
+
+# publish from local (optional)
+npm publish --access public
+
+# or publish via CI
+# git push --follow-tags
+```
+
+## Notes
+
+- Event bridge uses structured Codex session events and maps them to Claude-style hook events.
+- If you only need base sync (skills + mcp), run `crs sync-base`.
+- Example project config: `examples/.claude-codex-sync.example.json`.
+
+## License
+
+MIT

package/bin/crs.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require('child_process');
+const path = require('path');
+
+function printHelp() {
+  console.log(`claude-runtime-sync CLI
+
+Usage:
+  crs sync [flags]              Sync Claude source-of-truth into Codex
+  crs check [flags]             Check drift only (exit code 1 when drift exists)
+  crs bridge [flags]            Run Codex plugin bridge
+  crs hook install [zshrc]      Install zsh codex auto-sync hook
+  crs hook remove [zshrc]       Remove zsh codex auto-sync hook
+  crs sync-base [flags]         Run base sync (skills+mcp)
+  crs --help
+
+Common flags:
+  --codex-home=PATH
+  --claude-home=PATH
+  --project-root=PATH
+  --no-home
+  --no-project
+`);
+}
+
+function runNodeScript(scriptPath, args) {
+  const result = spawnSync(process.execPath, [scriptPath, ...args], {
+    stdio: 'inherit',
+    env: process.env
+  });
+
+  if (result.error) {
+    throw result.error;
+  }
+
+  if (typeof result.status === 'number') {
+    process.exit(result.status);
+  }
+
+  process.exit(1);
+}
+
+const argv = process.argv.slice(2);
+if (argv.length === 0 || argv[0] === '-h' || argv[0] === '--help' || argv[0] === 'help') {
+  printHelp();
+  process.exit(0);
+}
+
+const command = argv[0];
+const rest = argv.slice(1);
+
+const srcRoot = path.join(__dirname, '..', 'src');
+const runtimeSyncScript = path.join(srcRoot, 'claude-runtime-sync.js');
+const bridgeScript = path.join(srcRoot, 'codex-plugin-bridge.js');
+const hookScript = path.join(srcRoot, 'install-codex-zsh-hook.js');
+const baseSyncScript = path.join(srcRoot, 'sync-claude-all-to-codex.js');
+
+if (command === 'sync') {
+  runNodeScript(runtimeSyncScript, rest);
+}
+
+if (command === 'check') {
+  runNodeScript(runtimeSyncScript, ['--check', ...rest]);
+}
+
+if (command === 'bridge') {
+  runNodeScript(bridgeScript, rest);
+}
+
+if (command === 'sync-base') {
+  runNodeScript(baseSyncScript, rest);
+}
+
+if (command === 'hook') {
+  const mode = rest[0];
+  if (mode !== 'install' && mode !== 'remove') {
+    console.error('hook 子命令仅支持 install/remove');
+    process.exit(1);
+  }
+
+  runNodeScript(hookScript, rest);
+}
+
+console.error(`未知命令: ${command}`);
+printHelp();
+process.exit(1);

package/examples/.claude-codex-sync.example.json

@@ -0,0 +1,15 @@
+{
+  "ignoreSkills": ["example-skill-to-ignore"],
+  "skillNameMap": {
+    "source-skill-name": "target-skill-name"
+  },
+  "ignorePlugins": ["example-plugin-to-ignore"],
+  "pluginNameMap": {
+    "task-notifier": "task-notifier"
+  },
+  "ignoreHookSources": ["home"],
+  "ignoreMcpServers": ["Example MCP To Ignore"],
+  "mcpNameMap": {
+    "Chrome DevTools MCP": "chrome-devtools-mcp"
+  }
+}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "claude-runtime-sync",
+  "version": "0.1.0",
+  "description": "Use Claude config as the single source of truth and sync reusable capabilities into Codex runtime.",
+  "license": "MIT",
+  "type": "commonjs",
+  "bin": {
+    "crs": "./bin/crs.js",
+    "claude-runtime-sync": "./bin/crs.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "examples",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "claude",
+    "codex",
+    "mcp",
+    "skills",
+    "hooks",
+    "plugins",
+    "sync"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/strzhao/claude-runtime-sync.git"
+  },
+  "homepage": "https://github.com/strzhao/claude-runtime-sync",
+  "bugs": {
+    "url": "https://github.com/strzhao/claude-runtime-sync/issues"
+  },
+  "scripts": {
+    "check": "node -c bin/crs.js && node -c src/claude-runtime-sync.js && node -c src/sync-claude-all-to-codex.js && node -c src/codex-plugin-bridge.js && node -c src/install-codex-zsh-hook.js",
+    "smoke": "node bin/crs.js --help",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}