claude-code - 💡(How to fix) Fix Claude Code project history lost after renaming local root directory [1 participants]

Error Messages/Logs

TL;DR

Renaming the project root folder breaks conversation history in Claude Code, suggesting a need for a persistent project identifier to maintain session continuity.

Guidance

• Investigate the possibility of using a relative path or a project-specific identifier instead of relying on the absolute local path for session indexing.
• Consider implementing a mechanism, such as a .claude ID file or a claude link command, to re-associate an existing session history with a renamed directory.
• Review the Claude Code documentation and source code to understand how session history is currently stored and retrieved, and identify potential areas for modification.
• Test the behavior on different platforms and operating systems to determine if this is a Windows-specific issue or a more general problem.

Example

No specific code example can be provided without access to the Claude Code source code, but a potential solution might involve storing the session history in a file or database that is identified by a project-specific ID rather than the absolute path.

Notes

The issue may be related to how Claude Code stores and retrieves session history, and modifying this behavior may require significant changes to the underlying code. Additionally, the fact that renaming the folder back to its original name restores the conversation history suggests that the issue is specific to the absolute path used by Claude Code.

Recommendation

Apply a workaround, such as using a symbolic link or a junction to maintain the original folder name, until a more permanent solution can be implemented. This will allow users to continue using Claude Code with renamed project folders while a more robust solution is developed.