| name | localdocs-til-link |
| description | Links a project's localdocs/ folder to the TIL repository via symlink for centralized document management. Use when setting up a new project, after accidentally deleting localdocs/, or when connecting localdocs/ to a TIL repo for git-backed persistence. Triggered by requests like "link localdocs to TIL", "setup localdocs symlink", or "/localdocs-til-link 802 that-night-sky". |
localdocs-til-link
Connects a project's localdocs/ to the TIL repo via symlink. Real files live in TIL (git-managed); the project sees localdocs/ as if it were a normal directory.
Prerequisites
Ask the user for the following if not provided as arguments:
- TIL folder name โ the subdirectory inside TIL for this project, e.g.
"802 that-night-sky"
- TIL_BASE โ absolute path to the TIL repository root, e.g.
~/20_DocHub/TIL
Resolve TIL_BASE to an absolute path before use (expand ~ if needed).
PROJECT_LOCALDOCS={project_root}/localdocs
Workflow
1. Check current state
ls -la {PROJECT_LOCALDOCS}
ls "{TIL_BASE}/{til_folder}"
- If
localdocs/ is already a symlink (-> in ls -la), stop and inform the user.
- If the TIL folder doesn't exist, confirm with the user before creating it.
2. Merge (when both sides have files)
Copy TIL โ localdocs, no overwrite:
rsync -av --ignore-existing "{TIL_BASE}/{til_folder}/" "{PROJECT_LOCALDOCS}/"
For files with differing timestamps, show the diff and ask the user which side is authoritative.
3. Move and create symlink
rm -rf "{TIL_BASE}/{til_folder}"
mv "{PROJECT_LOCALDOCS}" "{TIL_BASE}/{til_folder}"
ln -s "{TIL_BASE}/{til_folder}" "{PROJECT_LOCALDOCS}"
4. Verify
ls -la {PROJECT_LOCALDOCS}
ls "{TIL_BASE}/{til_folder}/"
Notes
localdocs/ must be in the project's .gitignore. If missing, recommend adding it.- Always quote paths containing spaces.
- After setup, remind the user to commit in the TIL repo.
