Add install.sh --force to repoint symlinks and document the worktree caveat #17

New Issue

2026-06-30T14:14:55+02:00

Brummel commented

2026-06-30 14:14:55 +02:00

install.sh skips a symlink that already points elsewhere
(install.sh:37), so there is no scripted way to repoint the
~/.claude/{skills,agents,workflows} symlinks at a different checkout.
Because the symlink target is the absolute path of the clone install was
first run from (install.sh:19,44), a second checkout cannot take over
the live set, and INSTALL.md does not warn about it.

INSTALL.md:60 ("Symlinks pick up the changes automatically") holds only
for the single primary clone; it offers no worktree caveat. This compounds
the no-worktree rule recorded for this repo in CLAUDE.md (#15).

Changes:

install.sh gains a --force flag that repoints an existing symlink
pointing elsewhere (otherwise unchanged, still idempotent).
INSTALL.md documents that the plugin must be developed in the primary
clone (not a worktree), and that --force repoints.

Acceptance:

./install.sh --force repoints an existing divergent symlink; the
no-flag run still skips it.
INSTALL.md carries the worktree caveat and the --force note.

`install.sh` skips a symlink that already points elsewhere (`install.sh:37`), so there is no scripted way to repoint the `~/.claude/{skills,agents,workflows}` symlinks at a different checkout. Because the symlink target is the absolute path of the clone install was first run from (`install.sh:19,44`), a second checkout cannot take over the live set, and `INSTALL.md` does not warn about it. `INSTALL.md:60` ("Symlinks pick up the changes automatically") holds only for the single primary clone; it offers no worktree caveat. This compounds the no-worktree rule recorded for this repo in `CLAUDE.md` (#15). Changes: - `install.sh` gains a `--force` flag that repoints an existing symlink pointing elsewhere (otherwise unchanged, still idempotent). - `INSTALL.md` documents that the plugin must be developed in the primary clone (not a worktree), and that `--force` repoints. Acceptance: - [ ] `./install.sh --force` repoints an existing divergent symlink; the no-flag run still skips it. - [ ] `INSTALL.md` carries the worktree caveat and the `--force` note.

Brummel referenced this issue from a commit

2026-06-30 14:17:51 +02:00

feat(install): add --force to repoint symlinks; document worktree caveat

Brummel closed this issue

2026-06-30 14:17:51 +02:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Brummel/Skills#17