fix(init): create a junction for .agents/skills on Windows and report link failures honestly - #263
Open
ophiocus wants to merge 1 commit into
Open
fix(init): create a junction for .agents/skills on Windows and report link failures honestly#263ophiocus wants to merge 1 commit into
ophiocus wants to merge 1 commit into
Conversation
… link failures honestly On Windows without Developer Mode the skills symlink fails with EPERM and init blamed "filesystem without symlink support" - the wrong cause and no remedy (theam#230). Directory junctions need no privileges, so init now falls back to one (absolute target, said out loud in the ok line) and, when even that fails, names the two real fixes. The init end-to-end test also spawned Biome through its POSIX .bin shim, which spawnSync cannot execute on Windows (status null) - masked until now because the symlink death came first; it now runs Biome's JS entry through node. init.test.mjs: 8/8 on Windows for the first time, 8/8 on Linux unchanged. Closes theam#230 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
ophiocus
force-pushed
the
fix/windows-skills-junction
branch
from
September 3, 2026 18:25
d1eefbc to
dad6500
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #230 — credit to @Julian-Genuario for the precise report: EPERM on Windows without Developer Mode, blamed on "filesystem without symlink support." Claimed in-thread with right of way offered; the courtesy window has passed, so here is the fix, verified on the reporting platform.
The fix
Found underneath (masked until now)
The init end-to-end test also spawned Biome through its POSIX
.binshim, whichspawnSynccannot execute on Windows (statusnull) — invisible before because the symlink death always came first. It now runs Biome's JS entry through node, same behavior everywhere.Verified
init.test.mjs: 8/8 on Windows 11 — the first time that file has ever passed there — and 8/8 on Linux, unchanged.Interplay with #245, stated plainly: that PR's
verify-windowsCI job currently skips the init e2e naming this issue as its unskip criterion. Once both land, a one-line follow-up removes the skip and the whole init flow is guarded onwindows-latestforever. Happy to push that follow-up the moment the second of the two merges.