Skip to content

uv can cache repos with inadvertent dangling symlinks that break uv cache clean #15541

@Owen-OptiGrid

Description

@Owen-OptiGrid

Summary

We have a package in our org that we import as a git repo source into our other repos. In our package code I symlinked AGENTS.md to .github/copilot-instructions.md as we use the Codex coding agent and GitHub Copilot. The issue was in the uv cache for our package all . prefixed folders were excluded (so no .github directory) which left my AGENTS.md as a dangling symlink. Which didn't cause any issues until I tried to run uv cache clean which errored with an os error.

Image

I now know not to symlink to files in . prefixed directories like this... although I do wonder if uv could've handled this issue more gracefully.

Platform

Windows 11 x86_64

Version

uv 0.8.13 (ede75fe 2025-08-21)

Python version

Python 3.13.7

Metadata

Metadata

Assignees

Labels

bugSomething isn't working

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions