Recnys is a simple tool for dotfile synchronization. I coded it primarily for personal use.
It supports Windows and Linux platforms.
Use uv for installation:
uv tool install recnysAfter installation, there will be an executable named recnys.
See the specification document for the configuration file format. See the features document for the supported features.
With the configuration file correctly set, run recnys in the dotfile repository root, then the
synchronization will start:
recnysTip: Consider adding an alias for
recnys, since this name is not very intuitive. I personally alias it tore:).
Recnys supports dry-run mode. In this mode, no actual file operations will be performed, but the actions that would be executed will be printed to the console.
If an error occurs during dry run, normally a helpful message will be printed to the console to give you a hint about how to fix this error.
Therefore, it is highly recommended to first run recnys in dry-run mode to check if it will
perform the desired actions, and fix any possible errors in advance.
recnys --dry-runIf an error occurs during the actual run, don't worry, recnys is robust to interruption by storing
execution status under the .recnys/ directory. All we need to do is following the printed hint to
fix this error and then rerun recnys to continue the execution from the last failure point.