Repository navigation
Snapshot feature consumes excessive disk space (170GB+ in my case) #17753
Description
Description
The snapshot feature accumulated 170GB of disk space on my Mac. The git objects in ~/.local/share/opencode/snapshot/ grew unchecked over time.
Root Cause
Looking at packages/opencode/src/snapshot/index.ts:
- The entire worktree is tracked via git
- Cleanup only runs hourly via scheduler with
git gc --prune=7.days - No disk space warning when snapshot grows large
- Temporary pack files (
tmp_pack_*) may not be cleaned up if opencode crashes
Steps to Reproduce
- Use opencode regularly over time
- Check
~/.local/share/opencode/snapshot/directory size - In my case:
du -sh ~/.local/share/opencode/snapshot/showed 170GB
Workaround
- Delete the snapshot directory:
rm -rf ~/.local/share/opencode/snapshot/ - Disable snapshot in config:
{"snapshot": false}
Suggested Fix
Add a disk space warning when the snapshot directory exceeds a threshold (e.g., 1GB). This would alert users before the problem gets out of hand.
I'm willing to submit a PR for this if the maintainers agree with the approach.
Environment
- OS: macOS Sequoia 15.3
- OpenCode: latest (via brew)
Reacted by johnkea
Activity
github-actions commentedon Mar 16, 2026
This issue might be a duplicate of existing issues. Please check:
If your issue is the same, please consider adding a "+1" or additional context to one of those existing issues rather than opening a new one.
fix(snapshot): add disk space warning when snapshot grows large
JinHanAI commentedon Mar 16, 2026
I've submitted PR #17757 to address this issue.
JinHanAI commentedon Mar 16, 2026
Reopened as PR #17811 with proper template format.
fix(snapshot): add disk space warning when snapshot grows large
Znerual commentedon Mar 23, 2026
Same issue here, I would like to have a better fix than just a warning that it eats so much storage. What information can I provide to aid with the solution? I assume its a bug, there is no reason to store GBs of information for code changes. I had it in previous versions of opencode, it would be great if there was a cleanup feature to delete specific snapshot content for older sessions.
thdxr commentedon Mar 25, 2026
This should be fixed by commit 0a80ef4 which adds a 2MB file size limit for snapshotting. Files over 2MB are now excluded from git snapshots, reducing overall snapshot storage consumption.