OpenCode IDE Support

OpenCode IDE Support

Overview

planning-with-files works with OpenCode as a personal or project skill.

Installation

See .opencode/INSTALL.md for detailed installation instructions.

Quick Install (Global)

mkdir -p ~/.config/opencode/skills
cd ~/.config/opencode/skills
git clone https://github.com/OthmanAdi/planning-with-files.git

Quick Install (Project)

mkdir -p .opencode/skills
cd .opencode/skills
git clone https://github.com/OthmanAdi/planning-with-files.git

Usage with Superpowers Plugin

If you have obra/superpowers OpenCode plugin:

Use the use_skill tool with skill_name: "planning-with-files"

Usage without Superpowers

Manually read the skill file when starting complex tasks:

cat ~/.config/opencode/skills/planning-with-files/planning-with-files/SKILL.md

oh-my-opencode Compatibility

oh-my-opencode has Claude Code compatibility for skills. To use planning-with-files with oh-my-opencode:

Step 1: Install the skill

mkdir -p ~/.config/opencode/skills/planning-with-files
cp -r .opencode/skills/planning-with-files/* ~/.config/opencode/skills/planning-with-files/

Step 2: Configure oh-my-opencode

Add the skill to your ~/.config/opencode/oh-my-opencode.json (or .opencode/oh-my-opencode.json for project-level):

{
  "skills": {
    "sources": [
      { "path": "~/.config/opencode/skills/planning-with-files", "recursive": false }
    ],
    "enable": ["planning-with-files"]
  },
  "disabled_skills": []
}

Step 3: Verify loading

Ask the agent: "Do you have access to the planning-with-files skill? Can you create task_plan.md?"

Troubleshooting

If the agent forgets the planning rules:

1. Check skill is loaded: The skill should appear in oh-my-opencode's recognized skills
2. Explicit invocation: Tell the agent "Use the planning-with-files skill for this task"
3. Check for conflicts: If using superpowers plugin alongside oh-my-opencode, choose one method:
   • Use oh-my-opencode's native skill loading (recommended)
   • OR use superpowers' use_skill tool, but not both

Known Limitations

Session Catchup

The session-catchup.py script currently has limited support for OpenCode due to different session storage formats:

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

When you run /clear in OpenCode, session catchup will detect OpenCode and show a message. Workaround: Manually read task_plan.md, progress.md, and findings.md to catch up after clearing context.

Full OpenCode session parsing support is planned for a future release.

Verification

Global:

ls -la ~/.config/opencode/skills/planning-with-files/planning-with-files/SKILL.md

Project:

ls -la .opencode/skills/planning-with-files/planning-with-files/SKILL.md

Learn More

• Installation Guide
• Quick Start
• Workflow Diagram