claude-code - 💡(How to fix) Fix [BUG] Scheduled routines fail — virtiofs cannot mount through ~/Documents symlink (OneDrive Known Folder Move) [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#55176Fetched 2026-05-01 05:44:16
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Participants
Timeline (top)
labeled ×5

Error Message

RPC error: failed to mount /mnt/.virtiofs-root/shared/Users/<username>/Documents/Claude/Scheduled/<routine-name> as
.scheduled/<routine-name>: source path does not exist and could not be created:
/mnt/.virtiofs-root/shared/Users/<username>/Documents/Claude/Scheduled/<routine-name>: mkdir
/mnt/.virtiofs-root/shared/Users/<username>/Documents: file exists

Root Cause

All scheduled routines (cowork tasks) fail immediately on start with an RPC error. The Desktop app tries to
virtiofs-mount the SKILL.md directory from ~/Documents/Claude/Scheduled/<routine-name>, but ~/Documents is a symlink
created by OneDrive's Known Folder Move feature. The virtiofs implementation tries to mkdir the path component by
component and fails because it treats the symlink as a file, not a directory. This has been working for months and
broke with last night's update.

Fix Action

Fix / Workaround

No workaround is available: IT policy prevents disabling OneDrive Known Folder Move (the toggle is locked in OneDrive preferences), and setting ccdScheduledTasksEnabled: false in claude_desktop_config.json is reverted by the app on
restart.

Code Example

RPC error: failed to mount /mnt/.virtiofs-root/shared/Users/<username>/Documents/Claude/Scheduled/<routine-name> as   
  .scheduled/<routine-name>: source path does not exist and could not be created:                                     
  /mnt/.virtiofs-root/shared/Users/<username>/Documents/Claude/Scheduled/<routine-name>: mkdir                          
  /mnt/.virtiofs-root/shared/Users/<username>/Documents: file exists
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

All scheduled routines (cowork tasks) fail immediately on start with an RPC error. The Desktop app tries to
virtiofs-mount the SKILL.md directory from ~/Documents/Claude/Scheduled/<routine-name>, but ~/Documents is a symlink
created by OneDrive's Known Folder Move feature. The virtiofs implementation tries to mkdir the path component by
component and fails because it treats the symlink as a file, not a directory. This has been working for months and
broke with last night's update.

What Should Happen?

Scheduled routines should start successfully. The virtiofs implementation should resolve symlinks in the mount source path, as it did in previous versions.

Error Messages/Logs

RPC error: failed to mount /mnt/.virtiofs-root/shared/Users/<username>/Documents/Claude/Scheduled/<routine-name> as   
  .scheduled/<routine-name>: source path does not exist and could not be created:                                     
  /mnt/.virtiofs-root/shared/Users/<username>/Documents/Claude/Scheduled/<routine-name>: mkdir                          
  /mnt/.virtiofs-root/shared/Users/<username>/Documents: file exists

Steps to Reproduce

  1. On macOS, have OneDrive configured with Known Folder Move so that ~/Documents is a symlink to
    ~/Library/CloudStorage/OneDrive-<org>/Documents
  2. Have scheduled routine SKILL.md files at ~/Documents/Claude/Scheduled/<name>/SKILL.md
  3. Attempt to start any scheduled routine in Claude Desktop
  4. RPC error appears immediately — routine never starts

Claude Model

Sonnet (default)

Is this a regression?

Yes, this worked in a previous version

Last Working Version

No response

Claude Code Version

2.1.123

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

Platform note: This occurs in the Claude Code Desktop app (macOS), not via direct API usage. The form doesn't have a
Desktop option so selecting Anthropic API as closest match.

No workaround is available: IT policy prevents disabling OneDrive Known Folder Move (the toggle is locked in OneDrive preferences), and setting ccdScheduledTasksEnabled: false in claude_desktop_config.json is reverted by the app on
restart.

extent analysis

TL;DR

The issue can be fixed by modifying the virtiofs implementation to resolve symlinks in the mount source path.

Guidance

  • The error occurs because the virtiofs implementation treats the symlink ~/Documents as a file, not a directory, causing the mkdir operation to fail.
  • To verify the issue, check the error logs for the "source path does not exist and could not be created" error message.
  • A potential workaround could be to modify the ~/Documents symlink to a directory, if possible, or to use a different directory that is not a symlink.
  • The root cause of the issue is likely a change in the virtiofs implementation that broke the handling of symlinks in the mount source path.

Example

No code snippet is provided as the issue is related to the virtiofs implementation, which is not explicitly shown in the issue body.

Notes

The issue is specific to the Claude Code Desktop app on macOS, and the workaround is limited by IT policy restrictions on disabling OneDrive Known Folder Move.

Recommendation

Apply a workaround by modifying the virtiofs implementation or using a different directory, as upgrading to a fixed version is not currently possible due to the lack of information on the last working version.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING