claude-code - 💡(How to fix) Fix Edit tool: fails when linter/formatter modifies file between Read and Edit

TL;DR

Implementing an auto-re-read feature when a file modification is detected is the most likely fix to resolve the Edit tool failure due to race conditions with auto-formatters.

Guidance

• Consider implementing Auto-re-read as suggested, which would automatically re-read the file and retry the match against the new content when a modification is detected.
• Displaying a diff between expected and actual file content could help users understand what changes were made by the formatter, aiding in debugging.
• Introducing a brief retry window of 500ms after detecting a modification, re-reading, and retrying once before failing could mitigate the issue.
• Evaluate the feasibility of integrating with existing format-on-save tools (like Prettier, Black) and pre-commit hooks to synchronize or delay formatting until the Edit tool operation is complete.

Example

No specific code example is provided due to the lack of detailed implementation context, but the approach would involve detecting file modifications, re-reading the file, and retrying the edit operation.

Notes

The effectiveness of these suggestions may vary depending on the specific project setup, the speed of the auto-formatters, and the frequency of file modifications. Testing these approaches in a controlled environment before implementing them in production is recommended.

Recommendation

Apply the Auto-re-read workaround as it directly addresses the race condition issue by ensuring the Edit tool works with the most current version of the file, thus preventing failures due to modifications by auto-formatters or pre-commit hooks.