fix-symlink-shebang-persistence

name	fix-symlink-shebang-persistence
description	Permanently fix shebang issues in symlinked CLI tools that get overwritten by git updates
version	1.0.0
source	auto-extracted
extracted	"2026-04-10T00:00:00.000Z"
metadata	{"tags":["debugging","symlinks","cli-tools","python","venv"]}

Fix Symlink Shebang Persistence

When a symlink points to a git-tracked repo file with a generic shebang (e.g., #!/usr/bin/env python3), edits get overwritten on git pull. Instead of editing the repo file, repoint the symlink to the venv's generated entry point (e.g., ~/.venv/bin/hermes), which has the correct venv-specific shebang and isn't git-tracked. Use ln -sf <new-target> <symlink> to update the symlink target.