# Fix Symlink Shebang Persistence

> Permanently fix shebang issues in symlinked CLI tools that get overwritten by git updates

- Skill: `vamseeachanta/fix-symlink-shebang-persistence` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/fix-symlink-shebang-persistence`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/fix-symlink-shebang-persistence/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/fix-symlink-shebang-persistence

---


# 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.