sync-agents-settings 0.1.0 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +51 -34
  2. package/dist/cli.js +1 -1
  3. package/package.json +8 -3
package/README.md CHANGED
@@ -1,7 +1,7 @@
1
1
  # sync-agents-settings
2
2
 
3
3
  [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
4
- [![version](https://img.shields.io/badge/version-0.1.0-blue)](package.json)
4
+ [![npm](https://img.shields.io/npm/v/sync-agents-settings?logo=npm)](https://www.npmjs.com/package/sync-agents-settings)
5
5
  [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue?logo=typescript)](https://www.typescriptlang.org/)
6
6
  [![Node.js](https://img.shields.io/badge/Node.js-%3E%3D18-green?logo=node.js)](https://nodejs.org/)
7
7
  [![pnpm](https://img.shields.io/badge/pnpm-%3E%3D9-orange?logo=pnpm)](https://pnpm.io/)
@@ -20,45 +20,66 @@ If you use Claude Code as your primary AI coding agent but also switch between o
20
20
 
21
21
  This tool lets you configure MCP servers once in Claude Code, then sync everywhere with a single command.
22
22
 
23
- ## Install
23
+ ## Quick Start
24
24
 
25
- ```bash
26
- pnpm install
27
- ```
28
-
29
- ## Usage
25
+ No installation needed — just run with `npx`:
30
26
 
31
27
  ```bash
32
28
  # List all MCP servers detected from Claude Code
33
- npx tsx src/cli.ts list
29
+ npx sync-agents-settings list
34
30
 
35
31
  # Preview sync (no files modified)
36
- npx tsx src/cli.ts sync --dry-run
32
+ npx sync-agents-settings sync --dry-run
37
33
 
38
34
  # Sync to all targets (with automatic backup)
39
- npx tsx src/cli.ts sync
35
+ npx sync-agents-settings sync
36
+ ```
40
37
 
38
+ ## Install (optional)
39
+
40
+ ```bash
41
+ # Global install for the `sync-agents` command
42
+ npm install -g sync-agents-settings
43
+
44
+ # Then use directly
45
+ sync-agents list
46
+ sync-agents sync
47
+ ```
48
+
49
+ ## Usage
50
+
51
+ ```bash
41
52
  # Sync to a specific target
42
- npx tsx src/cli.ts sync --target gemini
43
- npx tsx src/cli.ts sync --target codex
44
- npx tsx src/cli.ts sync --target opencode
45
- npx tsx src/cli.ts sync --target kiro
46
- npx tsx src/cli.ts sync --target cursor
53
+ sync-agents sync --target gemini
54
+ sync-agents sync --target codex
55
+ sync-agents sync --target opencode
56
+ sync-agents sync --target kiro
57
+ sync-agents sync --target cursor
47
58
 
48
59
  # Sync to Codex project-level config
49
- npx tsx src/cli.ts sync --target codex --codex-home ./my-project/.codex
60
+ sync-agents sync --target codex --codex-home ./my-project/.codex
50
61
 
51
62
  # Compare differences
52
- npx tsx src/cli.ts diff
63
+ sync-agents diff
53
64
 
54
65
  # Skip OAuth-only servers (e.g. Slack)
55
- npx tsx src/cli.ts sync --skip-oauth
66
+ sync-agents sync --skip-oauth
56
67
 
57
68
  # Skip backup
58
- npx tsx src/cli.ts sync --no-backup
69
+ sync-agents sync --no-backup
59
70
 
60
71
  # Verbose output
61
- npx tsx src/cli.ts sync -v
72
+ sync-agents sync -v
73
+ ```
74
+
75
+ ### Development
76
+
77
+ ```bash
78
+ git clone https://github.com/Leoyang183/sync-agents-settings.git
79
+ cd sync-agents-settings
80
+ pnpm install
81
+ pnpm dev list # Run from source
82
+ pnpm test # Run tests
62
83
  ```
63
84
 
64
85
  ## How It Works
@@ -284,30 +305,26 @@ MIT
284
305
 
285
306
  這個工具讓你只在 Claude Code 設定一次 MCP servers，一行指令同步到所有目標。
286
307
 
287
- ### 安裝
288
-
289
- ```bash
290
- pnpm install
291
- ```
308
+ ### 快速開始
292
309
 
293
- ### 使用方式
310
+ 不需安裝，直接用 `npx`：
294
311
 
295
312
  ```bash
296
313
  # 列出所有 Claude Code 的 MCP servers
297
- npx tsx src/cli.ts list
314
+ npx sync-agents-settings list
298
315
 
299
316
  # 預覽同步（不修改任何檔案）
300
- npx tsx src/cli.ts sync --dry-run
317
+ npx sync-agents-settings sync --dry-run
301
318
 
302
319
  # 同步到所有目標（自動備份）
303
- npx tsx src/cli.ts sync
320
+ npx sync-agents-settings sync
304
321
 
305
322
  # 同步到特定目標
306
- npx tsx src/cli.ts sync --target gemini
307
- npx tsx src/cli.ts sync --target codex
308
- npx tsx src/cli.ts sync --target opencode
309
- npx tsx src/cli.ts sync --target kiro
310
- npx tsx src/cli.ts sync --target cursor
323
+ npx sync-agents-settings sync --target gemini
324
+ npx sync-agents-settings sync --target codex
325
+ npx sync-agents-settings sync --target opencode
326
+ npx sync-agents-settings sync --target kiro
327
+ npx sync-agents-settings sync --target cursor
311
328
  ```
312
329
 
313
330
  ### 運作原理
package/dist/cli.js CHANGED
@@ -13,7 +13,7 @@ const program = new Command();
13
13
  program
14
14
  .name("sync-agents")
15
15
  .description("Sync Claude Code MCP settings to Gemini CLI / Codex CLI / OpenCode / Kiro CLI")
16
- .version("0.1.0");
16
+ .version("0.1.2");
17
17
  program
18
18
  .command("sync")
19
19
  .description("Sync MCP settings from Claude Code to other CLIs")
package/package.json CHANGED
@@ -1,11 +1,12 @@
1
1
  {
2
2
  "name": "sync-agents-settings",
3
3
  "packageManager": "pnpm@10.32.1",
4
- "version": "0.1.0",
4
+ "version": "0.1.2",
5
5
  "description": "Sync MCP server configurations from Claude Code to Gemini CLI and Codex CLI",
6
6
  "main": "dist/cli.js",
7
7
  "bin": {
8
- "sync-agents": "./dist/cli.js"
8
+ "sync-agents-settings": "dist/cli.js",
9
+ "sync-agents": "dist/cli.js"
9
10
  },
10
11
  "files": [
11
12
  "dist",
@@ -32,8 +33,12 @@
32
33
  "claude-code",
33
34
  "gemini-cli",
34
35
  "codex-cli",
36
+ "opencode",
37
+ "kiro",
38
+ "cursor",
35
39
  "sync",
36
- "agent",
40
+ "ai-agent",
41
+ "mcp-servers",
37
42
  "settings"
38
43
  ],
39
44
  "author": "Leoyang183",