Skip to content

[BUG] Claude Code hangs when accessing large session files (>50MB) #21022

New issue
New issue
Closed as not planned
Closed as not planned
[BUG] Claude Code hangs when accessing large session files (>50MB)#21022
Labels
area:corearea:tuibugSomething isn't workinghas reproHas detailed reproduction stepsperf:memoryplatform:linuxIssue specifically occurs on Linux

Description

@tlelekas-cloud
tlelekas-cloud
opened on Jan 26, 2026

Summary

Claude Code becomes completely unresponsive (90% RAM usage, infinite "Ruminating...") when attempting to access or grep large .jsonl session transcript files. A 102MB session file caused complete system freeze requiring force-kill.

Environment

  • OS: WSL2 Ubuntu 24.04 on Windows 11
  • Claude Code Version: (current as of 2026-01-26)
  • Symptom: Infinite "Ruminating..." with high memory usage

Reproduction Steps

  1. Run Claude Code session continuously for 3+ days (laptop in sleep mode, no shutdown/restart)
  2. Session transcript file grows to 100MB+ (8,366 lines in this case)
  3. Execute command that accesses old session (e.g., grep -i "pattern" ~/.claude/projects/[project-name]/[session-id]*.jsonl)
  4. Claude Code hangs indefinitely at "Running... Ruminating..."
  5. WSL memory usage climbs to 90%, entire system becomes unresponsive

Evidence

Session File That Caused Hang

-rw------- 1 user user 102M Jan 26 09:11 68a8f26e-b699-4fc1-8cf9-a54c67142511.jsonl
Lines: 8,366
Created: 2026-01-20 09:55 UTC
Last activity: 2026-01-23 23:31 UTC

Command That Hung

Bash(grep -i "F") ~/.claude/projects/[project-name]/e66cefac*.jsonl
                  ~/.claude/projects/[project-name]/d4b0538f*.jsonl
                  ~/.claude/projects/[project-name]/68a8f26e*.jsonl)

Screenshot Evidence

See attached screenshot showing:

  • Command stuck at "Running..."
  • Status: "Ruminating... (Esc to interrupt • 47s • ↓ 27 tokens)"
  • Previous successful grep on smaller sessions (e66cefac: 2.4MB returned 3937 lines)
  • Hang occurred when reaching 102MB session file

Additional Large Sessions Found

102M  68a8f26e-b699-4fc1-8cf9-a54c67142511.jsonl  (THE KILLER)
6.7M  505efcc6-69d6-4d56-bd3e-7f4ca02f1716.jsonl  (risky)
5.2M  0947dde8-ba89-4f47-839a-0ddc23560d26.jsonl  (borderline)

Impact

  • Critical: Requires force-kill of Claude Code process
  • Data Loss Risk: Lost work if current session not saved
  • System Impact: 90% RAM usage affects entire WSL/Windows system
  • User Experience: Cannot access old session history without triggering hang
  • Workflow Disruption: Long-running sessions (common in continuous dev environments) become time bombs

Root Cause Analysis

Sessions running continuously across multi-day periods (e.g., laptop sleep Friday → wake Monday) accumulate massive transcript files. Claude Code appears to:

  1. Load entire session .jsonl file into memory when accessed
  2. Lack size-based safeguards or streaming reads
  3. Not warn users about growing session sizes
  4. Attempt to process 100MB+ text files synchronously, blocking UI

Workaround Applied

Moved dangerous sessions (>5MB) to archive directory outside Claude Code's project scan path:

mkdir ~/archive-dangerous-sessions-2026-01-26
mv [large-sessions] ~/archive-dangerous-sessions-2026-01-26/

Feature Requests

1. Proactive Session Size Monitoring

  • Monitor active session size in real-time
  • Display session size in UI (e.g., status bar)
  • Warn user at thresholds:
    • 20MB: "Session size large, consider starting new session"
    • 40MB: "Session size critical, recommend closing and continuing in new session"
    • 50MB+: Auto-suggest session rotation

2. Graceful Large File Handling

  • Don't load entire .jsonl into memory for operations
  • Use streaming/chunked reads for grep/search
  • Implement size limits before loading
  • Show progress indicator for large file operations

3. Automatic Session Management

  • Option to auto-rotate sessions at configurable size (default: 25MB)
  • "Continue in new session" feature that:
    • Saves current session
    • Starts fresh session
    • Maintains context continuity
    • Links related sessions

4. Session Archival & Export

  • Built-in command to archive old sessions
  • Export sessions to readable format (markdown, HTML)
  • Compress inactive sessions
  • Cleanup tool for sessions older than X days

5. Better Error Handling

  • Detect when operation is taking too long (>30s)
  • Offer to cancel operation
  • Show "Large file warning" before processing
  • Don't let UI become completely unresponsive

Technical Suggestions

  1. Implement lazy loading for .jsonl files
  2. Add size checks before file operations
  3. Use memory-mapped files for large sessions
  4. Consider SQLite for session storage instead of JSON lines
  5. Implement session chunking/pagination

Expected Behavior

  • Claude Code should never hang, regardless of session file size
  • Large files should be handled gracefully with progress indicators
  • Users should receive proactive warnings before sessions become problematic
  • System should remain responsive even during large file operations

Actual Behavior

  • Claude Code hangs indefinitely
  • No warning about session size
  • No way to recover without force-kill
  • Lost access to historical session data

Additional Context

This issue particularly affects users with:

  • Continuous development workflows (laptop sleep vs shutdown)
  • Long-running debugging sessions
  • WSL2 environments (common for Claude Code + Windows users)
  • Limited RAM (the 102MB session consumed 90% of available memory)

Related Issues

(Search for related issues about: memory usage, hanging, large files, session management)

Note: This is a critical reliability issue that makes Claude Code unusable for long-running sessions. The lack of proactive monitoring means users discover the problem only when Claude Code hangs, not before.

Activity

  1. tlelekas-cloud
    added
    bugSomething isn't working
    on Jan 26, 2026
  2. github-actions
    added
    has reproHas detailed reproduction steps
    platform:linuxIssue specifically occurs on Linux
    area:tui
    area:core
    perf:memory
    on Jan 26, 2026

  3. github-actions commented on Jan 26, 2026

    @github-actions
    github-actionsBot
    on Jan 26, 2026 – with GitHub Actions

    Found 3 possible duplicate issues:

    1. Claude Code crashes with SIGABRT when session JSONL files exceed V8 heap limit #19025
    2. [BUG] Session files grow unboundedly, causing OOM crash on startup ("Aborted (core dumped)") #20367
    3. [BUG] Memory Leak from Unbounded Session File Growth #20200

    This issue will be automatically closed as a duplicate in 3 days.

    • If your issue is a duplicate, please close it and 👍 the existing issue instead
    • To prevent auto-closure, add a comment or 👎 this comment

    🤖 Generated with Claude Code

  4. tlelekas-cloud commented on Jan 26, 2026

    @tlelekas-cloud
    tlelekas-cloud
    on Jan 26, 2026
    Author

    From your proposed master Tickets, I can see no sufficient solution/handling of LARGE session files, because:

    1. large and older session files IF ARCHIVED may well still be needed/accessed to retrieve some discussion, meaning that AGAIN a Hang/Crash will occur
    2. large session files cleaned up, means those discussions are LOST which is not satisfactory

    So somehow both Keeping and Accessing (somehow) of large session files is needed as a solution, without risking Claude Code to hang or crash.

  5. oferchen commented on Jan 30, 2026

    @oferchen
    oferchen
    on Jan 30, 2026

    seems this is a blocking issue currently triaged to latest upstream

  6. Whuru commented on Jan 31, 2026

    @Whuru
    Whuru
    on Jan 31, 2026

    Additional Report: Freezing on Project Initialization (Not Just File Access)

    I'm experiencing this same issue, but with an additional symptom: Claude Code freezes during project initialization, even when NOT directly accessing the large files.

    My Experience

    Environment:

    • OS: Linux (WSL2)
    • Claude Code version: [latest as of Jan 30, 2026]

    File Sizes That Triggered Freezing:

    • 147MB conversation file (Jan 30)
    • 46MB conversation file (Jan 30)
    • 16MB conversation file (Jan 30)

    Symptoms:

    1. Resume command freezes - Gets stuck at "loading conversations" indefinitely
    2. Clean context window freezes - Even when starting a fresh conversation (not loading an old one), Claude Code hangs on first prompt submission
    3. Happens during initialization - The freeze occurs during project initialization, before any user interaction

    What Fixed It:
    Moving the large .jsonl files out of ~/.claude/projects/[project]/ to an archived location immediately resolved all freezing issues.

    Key Insight

    This suggests Claude Code is scanning/indexing ALL conversation files in the project directory during initialization to build the resume list or extract metadata. When it encounters large files (16MB+), it hangs before the user can even interact.

    This is more severe than just "accessing large files" - it prevents ANY use of Claude Code in that project directory until the large files are removed.

    Frequency

    This started happening very recently (past week) and never occurred before, suggesting a recent regression in how conversation files are indexed/scanned.

    Workaround

    Archiving conversations >10MB to a separate directory outside the projects folder prevents the freeze, but this is not sustainable for long-running projects.

    Related to:

    This appears to be part of a broader performance regression with large conversation files in recent Claude Code versions.

  7. junaidtitan commented on Feb 6, 2026

    @junaidtitan
    junaidtitan
    on Feb 6, 2026

    Same issue here — sessions over ~50MB consistently hang on resume. The problem is the sheer volume of accumulated entries in the JSONL file, particularly progress ticks and large tool outputs.

    Until there's a built-in solution, I've been using Cozempic to trim sessions back to a manageable size. It applies composable pruning strategies while preserving the conversation structure:

    pip install cozempic
cozempic current --diagnose          # Shows size breakdown
cozempic treat current -rx aggressive --execute  # For severely bloated files

    The aggressive prescription applies all 13 strategies including mega-block trimming (>32KB blocks) and document deduplication, which is usually what you need for 50MB+ files. Automatic backups are created before any changes.

    It also has a reload command that applies the treatment and automatically spawns a new terminal with claude --resume after you exit.

  8. github-actions
    added
    staleIssue is inactive
    on Feb 20, 2026

  9. github-actions commented on Mar 6, 2026

    @github-actions
    github-actionsBot
    on Mar 6, 2026 – with GitHub Actions

    Closing for now — inactive for too long. Please open a new issue if this is still relevant.

  10. github-actions
    closed this as not plannedon Mar 6, 2026

  11. tlelekas-cloud commented on Mar 9, 2026

    @tlelekas-cloud
    tlelekas-cloud
    on Mar 9, 2026
    Author

    What do you mean "inactive for too long. Please [open a new issue]"?

    HAS THIS BEEN RESOLVED to close it? Why are we WASTING TIME to open Bugs if you never resolve/reply to them properly?

  12. github-actions
    removed
    staleIssue is inactive
    on Mar 9, 2026

  13. github-actions commented on Mar 16, 2026

    @github-actions
    github-actionsBot
    on Mar 16, 2026 – with GitHub Actions

    This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.

  14. github-actions
    locked as resolved and limited conversation to collaborators on Mar 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:corearea:tuibugSomething isn't workinghas reproHas detailed reproduction stepsperf:memoryplatform:linuxIssue specifically occurs on Linux

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions