~/ugurcandede/apps/tools/claude-symlink claude-symlink

claude-symlinkv1.0.0

One repo for every
Claude config.

Your Claude Code .claude/ folders, each project’s .mcp.json and the Claude Desktop MCP config, kept in one repo and symlinked into place on every Mac and PC.

Get it GitHub →
~/Dropbox/claude-symlink
# once: set PROJECTS and FILESYSTEM_MCP_PATH in user-config.js
$ node setup-claude.js --check       # doctor only, zero writes
$ node setup-claude.js --fix-issues  # apply missing or wrong links

How it works

Render, then link.

  1. Detects the system. Windows or Mac.
  2. Finds the IDE’s MCP port. By asking the running IntelliJ IDEA over HTTP, or the fallback 64763.
  3. Renders one config per system. base.json plus the optional base.win.json or base.mac.json; <AUTO> and <FS_PATH> filled in.
  4. Creates the symlinks. Correct ones are left alone.
symlinks
# in each project
.claude    → projects/<project>/claude/
.mcp.json  → projects/<project>/mcp/link.<os>.json

# Claude Desktop
config     → claude-desktop/link.<os>.json

# optional, per project
extras     → .env and any other file you list

Safety

Nothing lost. Nothing guessed.

Run it as often as you like. A real file in the way is backed up first, a dry run shows every step, and the doctor checks the machine before anything is written.

Dependencies

0

Node's standard library only.

Doctor checks

7

Paths, sources, JSON, placeholders, orphans, Claude Desktop, the IDE.

Writes in --check

0

Look first, change later.

IdempotentCorrect symlinks are left alone.
BackupsA real file at a target becomes <name>.bak-YYYYMMDD-HHmmss first.
Dry run--dry-run shows every planned action, touches nothing.
UninstallRemoves only links that point at its own targets; the repo is never touched.
Missing rootsA project not on this machine is skipped and shown in red.
Stale configsA base.json newer than its rendered file is tagged yellow.

Get claude-symlink

Clone it where you sync.

git

Clone

Into Dropbox, iCloud Drive or any synced folder

GitHub 
$ git clone https://github.com/ugurcandede/claude-symlink
>_

Run

Check first, then fix

Quick start 
$ node setup-claude.js --check

Re-run --fix-issues any time a symlink is deleted or replaced. On Windows, turn on Developer Mode so symlinks need no administrator rights.

Read the guide →

RequiresNode.js, standard library only
SystemsWindows, macOS
WindowsDeveloper Mode on, for symlinks without admin
OptionalIntelliJ IDEA with the MCP Server plugin
Editsuser-config.js, and the configs in the repo
LicenseMIT