History accumulation in .claude.json causes performance issues and storage bloat

[ravikalla]

Description

The .claude.json file continuously accumulates conversation history for each project, leading to:

• File sizes growing to hundreds of MB or more
• Slower Claude Code startup times
• Potential system performance degradation
• No automatic cleanup mechanism

Current Behavior

• Every conversation in every project is stored indefinitely
• History entries include full conversation context, pasted contents, and metadata
• File can grow to 968KB+ (as observed) and continues growing
• No built-in limits or rotation mechanism

Expected Behavior

• Automatic history rotation/cleanup after reaching a size limit
• Configurable history retention (e.g., last N conversations or last X days)
• Option to disable history storage entirely
• Better separation of configuration (MCP servers) from history data

Impact

• Users must manually edit .claude.json to remove old history
• Risk of losing MCP server configurations during manual cleanup
• Performance degradation as file size increases
• Poor user experience for long-term users

Suggested Solutions

1. Implement automatic history rotation (e.g., keep only last 100 conversations per project)
2. Add configuration option for history retention limits
3. Separate history storage from configuration storage
4. Add claude history prune command with options like --older-than 30d
5. Show warnings when history file exceeds certain size thresholds

Environment

• Claude Code version: Latest
• OS: macOS (but affects all platforms)
• File size observed: 968KB+ and growing

Reproduction Steps

1. Use Claude Code regularly across multiple projects
2. Check ~/.claude.json file size after a few weeks/months
3. Observe performance degradation and file bloat

Workaround

Currently users must manually edit .claude.json or use claude history clear which removes ALL history across all projects.

[github-actions]

Found 3 possible duplicate issues:

1. Bug: .claude.json automatically stores conversation history when it shouldn't #1449
2. Unify MCP configuration and separate from conversation history #2539
3. Claude Code logs partial keystrokes and stores plaintext emails in ~/.claude.json #2713

If your issue is a duplicate, please close it and 👍 the existing issue instead.

🤖 Generated with Claude Code

[aretrace]

claude history clear
@ravikalla I'm unfamiliar with this cli command

[bStyler]

Experiencing the same issue.

[colonelpanic8]

@bcherny mentioned that this was being worked on a while ago (May 30th) #1449 (comment)

are there any updates on this work?

[jezweb]

do i just rename the file and move on? the file is 90mb and i cant even open it to edit the file

[sukakcoding]

+1