Feature Request: Storage Management & Chat History Cleanup in Kiro IDE

[clx-jlmoreno]

Feature Description

Suggestion built by kiro-cli, after review the disk usage.

Problem

Kiro IDE accumulates large amounts of chat history and session data with no built-in cleanup mechanism. After several months of use, storage can grow to 13GB+ with no way to manage it except manual file deletion.

Current Behavior

• Chat history stored in: ~/Library/Application Support/kiro/User/globalStorage/kiro.kiroagent/
• Multiple session directories accumulate (each 1-2GB)
• Old project sessions remain indefinitely
• No visibility into storage usage in IDE
• No cleanup options in Settings or Command Palette

Proposed Solution

IDE Command Palette

Cmd+Shift+P → "Kiro: Manage Storage"
Cmd+Shift+P → "Kiro: Clear Old Chat History"
Cmd+Shift+P → "Kiro: View Storage Usage"

IDE Settings UI

Settings → Kiro → Storage Management

• Visual breakdown of space usage by project/session
• List of old project sessions with size and last access date
• Checkboxes to select sessions for deletion
• "Clean Up Old Projects" button
• Retention policy configuration

Settings (settings.json)

{
  "kiro.storage.retentionDays": 90,
  "kiro.storage.maxSizeGB": 10,
  "kiro.storage.autoCleanup": true,
  "kiro.storage.warnAtSizeGB": 5
}

Optional: CLI Support

# For users who prefer terminal
kiro-cli storage info
kiro-cli storage clean --old-projects

Use Cases

1. Developer with multiple projects: Clean up old project sessions via IDE UI (saves 2-5GB)
2. Long-running projects: Archive old chat history while keeping task tracking
3. Storage-constrained systems: Automatic cleanup based on retention policy
4. Team environments: Consistent storage management across developers

Expected Behavior

• Preserve current project data and task tracking
• Show warning dialog before deletion with size to be freed
• Option to archive before deletion
• Dry-run preview of what will be deleted

Impact

• Prevents storage bloat (13GB+ observed in production use)
• Improves user experience (no manual file hunting in Application Support)
• Aligns with enterprise storage policies
• Matches behavior of other IDEs (VS Code has workspace storage cleanup)

Environment

• Kiro IDE (VS Code-based, latest preview)
• macOS 14.x
• Storage location: ~/Library/Application Support/kiro/User/globalStorage/kiro.kiroagent/
• Observed growth: ~13GB after 3 months of active use
• Current workaround: Manual rm -rf of session directories

Related

• Issue Message History Spontaneously Disappearing #1279 (chat history management)
• VS Code has similar storage management: "Developer: Clean Workspace Storage"

Screenshots/Evidence

$ du -sh ~/Library/Application\ Support/kiro/User/globalStorage/kiro.kiroagent
13G     kiro.kiroagent

# Multiple old project sessions:
12G     d1c95acd1215dbe372efb48819c04345/  (current project)
1.7G    c0a23e81228432f1086bb8684f5c0604/  (old project)
143M    b1a9dfdf8e3da69e70d440745dabdb5f/  (old project)

Use Case

working and see disk not becomes full.

Additional Context

No response

[github-actions]

🤖 Potential Duplicate Detected

This issue appears to be similar to:

• #4165: Unbounded growth of spec execution history in globalStorage (~8GB+ / 6000+ files) (92% similar)
• #4824: Rework of Sessions UX (85% similar)
• #4760: Bulk Session Management (Delete/Archive Multiple Sessions) (85% similar)

What happens next?

• ⏰ This issue will be automatically closed in 3 days
• 🏷️ Remove the duplicate label if this is NOT a duplicate
• 💬 Comment on the original issue if you have additional information

Why is this marked as duplicate?
Both report unbounded growth of Kiro storage in globalStorage directory on macOS, with similar file sizes (8GB+ vs 13GB+) and request cleanup mechanisms for accumulated session data

[clx-jlmoreno]

Really is a duplicate of #4165

[github-actions]

Thank you for your feedback! 🙏

The duplicate label has been removed and this issue has been sent back for maintainer review.

A maintainer will review this issue shortly.