manage-dotfiles
🎯Skillfrom poorrican/dotfiles
|Manages dotfiles across Linux/macOS systems using GNU stow, enabling seamless synchronization and configuration import/export.
Installation
npx skills add https://github.com/poorrican/dotfiles --skill manage-dotfilesSkill Details
Manage dotfiles and keep synced with external directories. Use on Linux / macOS systemswhen thetre are external connfigs which are being imported into the dotfiles, or when stored dotfiles need to be brought outside to the XDG environment.
Instructions
On Linux and macOS, dotfiles will be managed via GNU stow.
The stored dotfiles will use the XDG configuration for simplicity and organization.
The commands below assume that there is a specific config package which is being interacted with (eg: nvim)
Syncing Dotfiles - Exporting Configurations
Sync a dotfiles package to its target location using GNU stow.
Instructions
- Validate the package exists at
~/dotfiles/{package}:
- If it doesn't exist, list available packages (top-level directories in ~/dotfiles that aren't hidden or special like result, docs, ░▒▓ OLD ▓▒░)
- Fail with a clear error message
- Run stow to deploy the package:
```bash
stow -v -d ~/dotfiles -t ~ {package}
```
- Report what was linked. If stow reports conflicts, explain what's blocking and suggest using
stow -Dto unstow first, orstow -Rto restow.
Importing Configurations
Import an external config into the dotfiles repository and stow it.
Instructions
- Resolve the path: Expand
~and resolve to an absolute path. Verify the file/directory exists.
- Compute the home-relative path: The path must be under
$HOME. Strip the$HOMEprefix to get the relative path.
- Example: ~/.config/foo/bar.conf → .config/foo/bar.conf
- Example: ~/.zshrc → .zshrc
- Derive the package name:
- For .config/ paths → package name is
- For . (hidden file in home root) → package name is
- For .local/share/ → package name is
- For other structures → use the first directory component, or ask the user
- Create the package structure in
~/dotfiles:
```bash
mkdir -p ~/dotfiles/
```
Where
- Move the config into the package:
```bash
mv
```
- Stow the package to create symlinks:
```bash
stow -v -d ~/dotfiles -t ~
```
- Verify: Confirm the original path is now a symlink pointing into dotfiles.
Example
Importing ~/.config/wezterm/wezterm.lua:
- Package name:
wezterm - Creates:
~/dotfiles/wezterm/.config/wezterm/wezterm.lua - Symlinks:
~/.config/wezterm/→~/dotfiles/wezterm/.config/wezterm/
Notes
- If the package already exists, merge the new config into it
- Do NOT use
ln- only usestowfor symlinking - If importing a single file from a directory that has other files, ask if the user wants to import the entire directory or just the file