Skip to content

fix(opencode): standardize on plugins/ directory, fix symlink docs#349

Merged
obra merged 3 commits intomainfrom
fix/opencode-issues
Jan 23, 2026
Merged

fix(opencode): standardize on plugins/ directory, fix symlink docs#349
obra merged 3 commits intomainfrom
fix/opencode-issues

Conversation

@obra
Copy link
Owner

@obra obra commented Jan 23, 2026

Summary

  • Standardize on plugins/ (plural) per official OpenCode docs
  • Fix symlink instructions with explicit rm before ln -s
  • Add missing skills symlink step to INSTALL.md
  • Update all platforms (Linux, macOS, Windows CMD/PowerShell/Git Bash)
  • Bump version to 4.1.1

Issues Fixed

Test plan

  • Verified OpenCode loads from ~/.config/opencode/plugins/
  • Ran tests/opencode/test-plugin-loading.sh - all tests pass
  • Tested fresh install following updated docs

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes

    • Fixed symlink instructions to prevent file-exists errors during setup
    • Updated deprecated tool references to native equivalents
  • Documentation

    • Updated installation and setup guides to reflect new directory structure
    • Clarified plugin registration and skills configuration steps
    • Added verification steps for proper setup confirmation
  • Chores

    • Version bumped to 4.1.1

✏️ Tip: You can customize this high-level summary in your review settings.

obra and others added 3 commits January 23, 2026 17:33
Issues addressed:
- #342: INSTALL.md still referenced removed find_skills/use_skill tools
- #339: Symlink instructions could fail if target already exists

Changes:
- INSTALL.md: Added missing skills symlink step, updated to native skill tool
- INSTALL.md: Removed Node.js prerequisite (no longer needed)
- README.opencode.md: Added explicit rm before ln -s (ln -sf doesn't remove dirs)
- Both files: Use ln -s instead of ln -sf for clarity

Note: #343 (plugin vs plugins folder name) not addressed in this commit

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
OpenCode officially documents ~/.config/opencode/plugins/ (plural) as the
plugin directory. Our docs previously used plugin/ (singular), which also
works but caused confusion.

Changes:
- Renamed .opencode/plugin/ to .opencode/plugins/ in repo structure
- Updated INSTALL.md to use plugins/ everywhere
- Updated README.opencode.md (all platforms: Linux, macOS, Windows CMD,
  PowerShell, Git Bash) to use plugins/
- Updated test scripts to match

Tested: Both singular and plural forms work, but we now match official docs.

Fixes #343

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@obra obra merged commit 469a6d8 into main Jan 23, 2026
@coderabbitai
Copy link

coderabbitai bot commented Jan 23, 2026

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Walkthrough

This PR updates the OpenCode plugin and skills directory structure from .opencode/plugin/ to .opencode/plugins/ across installation instructions, documentation, release notes, and test scripts. It also bumps the plugin version from 4.1.0 to 4.1.1 to reflect these corrections.

Changes

Cohort / File(s) Summary
Plugin versioning
.claude-plugin/plugin.json
Bumps version from 4.1.0 to 4.1.1
Installation and documentation updates
.opencode/INSTALL.md, docs/README.opencode.md, RELEASE-NOTES.md
Updates directory references from .opencode/plugin/ to .opencode/plugins/ across installation steps, symlink targets, and usage guidance; reorganizes sections for clarity; adds missing skills symlink step; updates deprecated tool references
Test script updates
tests/opencode/setup.sh, tests/opencode/test-plugin-loading.sh
Updates all plugin directory paths and symlink targets from .opencode/plugin/ to .opencode/plugins/ and adjusts corresponding test assertions and echo messages

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

Poem

🐰 From plugin to plugins, the path now rings true,
Directory names aligned with what OpenCode knew,
Symlinks and scripts all point the right way,
Version bumped up to mark the new day! ✨

✨ Finishing touches
  • 📝 Generate docstrings

Comment @coderabbitai help to get the list of available commands and usage tips.

pcvelz pushed a commit to pcvelz/superpowers that referenced this pull request Jan 30, 2026
fix(opencode): standardize on plugins/ directory, fix symlink docs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

1 participant