cyberneticlibrary
← library

Create and audit cross-platform symlinks

symlink-managerskillsetup L2★3
richfrem/agent-plugins-skills ↗
What it does

Create, audit, repair and document cross-platform symlinks

Best for

Unifying symlink behavior across macOS, Linux, and Windows development teams.

Inputs
  • · Source path
  • · Destination path
  • · Git config state (core.symlinks)
Outputs
  • · Symlink created/repaired
  • · Audit report (broken/missing/text-file stand-ins)
Requires
  • · Python standard library (os, subprocess)
  • · git config
  • · Windows Developer Mode (optional)
  • · ln -s or equivalent OS symlink API
Preconditions

Python 3.8+; on Windows: Developer Mode or admin elevation for real symlinks

Failure modes
  • · Hardlink trap on Windows without Developer Mode
  • · core.symlinks=false causes plain-text file checkout
  • · Git re-commit breaks cross-platform workflow
Trust signals
  • · Detailed diagnosis script
  • · Python automation avoids shell incompatibilities
  • · Bulk fixer script
  • · Cross-platform testing table in docs