[GH-ISSUE #74] Opencode compatibility #47

Closed
opened 2026-03-03 18:50:15 +03:00 by kerem · 2 comments
Owner

Originally created by @MrCloth on GitHub (Feb 8, 2026).
Original GitHub issue: https://github.com/OthmanAdi/planning-with-files/issues/74

the session-catchup.py seems unable to run properly in Opencode due to the different way of storing session files between Claude Code and Opencode

Originally created by @MrCloth on GitHub (Feb 8, 2026). Original GitHub issue: https://github.com/OthmanAdi/planning-with-files/issues/74 the session-catchup.py seems unable to run properly in Opencode due to the different way of storing session files between Claude Code and Opencode
kerem closed this issue 2026-03-03 18:50:15 +03:00
Author
Owner

@OthmanAdi commented on GitHub (Feb 8, 2026):

Hey @MrCloth — I've identified and fixed the root cause.

The Problem

OpenCode and Claude Code use completely different session storage formats:

  • Claude Code: .jsonl files at ~/.claude/projects/
  • OpenCode: .json files at ~/.local/share/opencode/storage/session/

session-catchup.py was hardcoded for Claude Code's structure, so it silently failed on OpenCode.

The Fix

The script now detects which IDE you're using and shows a clear message:

[planning-with-files] OpenCode session catchup is not yet fully supported
OpenCode uses a different session storage format (.json) than Claude Code (.jsonl)

Workaround: Manually read task_plan.md, progress.md, and findings.md to catch up.

Changes

  • IDE detection (checks OPENCODE_DATA_DIR env var and directory structure)
  • Clear error message instead of silent failure
  • Updated OpenCode docs with the limitation

Full OpenCode session parsing will require restructuring the entire message extraction logic since OpenCode stores messages separately. For now, the workaround is to manually review your planning files after /clear.

Can you test this and confirm it shows the message correctly? If it works, I'll close this issue.

<!-- gh-comment-id:3867368032 --> @OthmanAdi commented on GitHub (Feb 8, 2026): Hey @MrCloth — I've identified and fixed the root cause. **The Problem** OpenCode and Claude Code use completely different session storage formats: - Claude Code: `.jsonl` files at `~/.claude/projects/` - OpenCode: `.json` files at `~/.local/share/opencode/storage/session/` `session-catchup.py` was hardcoded for Claude Code's structure, so it silently failed on OpenCode. **The Fix** The script now detects which IDE you're using and shows a clear message: ``` [planning-with-files] OpenCode session catchup is not yet fully supported OpenCode uses a different session storage format (.json) than Claude Code (.jsonl) Workaround: Manually read task_plan.md, progress.md, and findings.md to catch up. ``` **Changes** - IDE detection (checks `OPENCODE_DATA_DIR` env var and directory structure) - Clear error message instead of silent failure - Updated [OpenCode docs](https://github.com/OthmanAdi/planning-with-files/blob/master/docs/opencode.md) with the limitation Full OpenCode session parsing will require restructuring the entire message extraction logic since OpenCode stores messages separately. For now, the workaround is to manually review your planning files after `/clear`. Can you test this and confirm it shows the message correctly? If it works, I'll close this issue.
Author
Owner

@MrCloth commented on GitHub (Feb 11, 2026):

thanks

<!-- gh-comment-id:3882050489 --> @MrCloth commented on GitHub (Feb 11, 2026): thanks
Sign in to join this conversation.
No labels
bug
pull-request
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
starred/planning-with-files#47
No description provided.