-
Notifications
You must be signed in to change notification settings - Fork 2.4k
Description
TLDR
If you’re seeing the gray screen bug, you don’t need to read the whole issue. Just run VS Code like this: code --verbose.
When the screen goes gray, copy the output from that terminal and any errors from Developer Tools (Help > Toggle Developer Tools > Console tab).
Post those logs in the issue, along with your OS, VS Code version, Roo extension version, and what you were doing right before it happened.
Summary
This issue consolidates all findings from #2270 regarding the persistent "gray/blank screen" problem affecting multiple users across different platforms. After 3+ months of investigation and 35+ comments, this summary provides a clean overview of what we know and what still needs to be done.
Problem Description
Users experience a complete UI failure where the Roo Code extension window becomes gray/blank, requiring VS Code restart. The issue:
- Affects Windows, macOS, and Linux users
- Occurs during long-running tasks or with multiple VS Code instances
- Sometimes allows background task continuation despite UI failure
- Can result in permanent loss of task history access
- Frequency: Multiple times per day for affected users
- Has been reported since April 2025, still unresolved
User Reports Summary
- @ianlintner: "Running 4 instances of cursor, all gray screen of death at the same time on Mac. Deal with it half a dozen times during the day"
- @appscaptain: "Up at 57k context window, needs to run terminal command, whole interface becomes blank during thinking"
- @shanemmattner: "Gray screens every 1-2 hours, Roo is close to unusable"
- @NightOwlCoder: "Can't find good repro steps, it just happens"
- @Promethean-Pty-Ltd: "Getting greyed-out window several times a day... sometimes can no longer access Task and chat history"
Technical Findings
Identified Issues
-
Task History Storage: The
taskHistoryarray is stored in VS Code's globalState- Triggers warnings: "large extension state detected (1.4MB+)"
- Entire array propagated to webview on every state update
- Sequential scanning of thousands of HistoryItem objects
-
Memory Management:
- Large
taskstrings in HistoryItem objects - No pruning mechanism for historical data
- Inefficient state synchronization
- Large
-
Potential Causes:
- Race conditions with multiple VS Code instances
- WebView context retention issues
- Memory pressure from large state transfers
Reproduction Attempts
No consistent reproduction steps found despite extensive efforts.
Common patterns observed:
- Long-running tasks with high token usage (50k+ contexts)
- Multiple VS Code instances with Roo active
- Frequent terminal command approvals
- Extended usage periods (1-2 hours)
- Heavy usage with advanced models (DeepSeek R1, Gemini 2.5 Pro)
Current Workarounds
Users have reported these temporary solutions:
- Increase VS Code heap size:
code --max-memory=8192 - Regularly close completed tasks
- Restart VS Code when issue occurs
- Limit to single VS Code instance
- Close all editor windows for long-running tasks
Investigation Status
Attempted Solutions
- PR 3 of 3: scalability fix: refactor task history persistence to use file-based storage #3785: Proposed file-based storage migration (status unknown)
- PR Add a JSONL implementation with benchmark and findings #2868: JSONL implementation (closed)
- Various debugging attempts with
code --verbose
What We Still Need
- Reliable Reproduction Steps: Critical for debugging
- Stack Traces: When gray screen occurs with
code --verbose - Memory Profiling: During the failure state
- Error Boundaries: To capture and report failures
Next Steps
-
Find Reliable Reproduction
- Need users to run
code --verboseand capture logs - Document exact steps when issue occurs
- Capture memory usage patterns
- Need users to run
-
Implement Diagnostics
- Add error boundaries to catch UI failures
- Implement telemetry for state size monitoring
- Add debug logging for state operations
-
Develop Fix Strategy
- Based on reproduction findings
- May require fundamental architecture changes
- Need to address both storage and UI resilience
How to Help
If you experience this issue:
- Launch VS Code with:
code --verbose - Note exact actions before gray screen
- Capture console output
- Report VS Code version, OS, and extension version
- Check Developer Tools console for errors
Related Issues
- Original issue: Extension goes "blank" / Grey Screen #2270
- Related: Grey/blank Screen or Crashing Related #2391 (closed)
This is a summary of the ongoing investigation. The original issue (#2270) contains the full discussion history.
Metadata
Metadata
Assignees
Labels
Type
Projects
Status