Repolode
lay-wang

lay-wang/opencode-plugin-toggle

An OpenCode desktop session-header button to toggle installed plugins on and off and insert @skill mentions into the prompt.

Stars
2
Forks
0
Open issues
0
Last commit
yesterday

What is it?

opencode-plugin-toggle adds a button to the session header of the OpenCode desktop app. Clicking it opens a popover listing the plugins in your global config, each with a short description and an on/off switch, along with the available skills.

Turning a plugin off appends a "-<plugin-id>" entry to the global plugins array, and turning it back on removes that line. The server reloads without a restart. Disabled plugins remain in the list greyed out, and plugins that failed to load show their error. Each config write is validated and backed up before the change is applied.

Clicking a skill inserts an @skill-id mention into the prompt. Because skills are loaded by the agent, this is a mention rather than a direct invocation. Toggling is limited to the global config, and skills contributed by a plugin can only be disabled by turning off the whole plugin.

Key features

  • 01Lists globally configured plugins with descriptions and on/off switches.
  • 02Toggles plugins by editing the global plugins array, with no restart needed.
  • 03Keeps disabled plugins visible and shows errors for plugins that failed to load.
  • 04Inserts @skill-id mentions into the prompt by clicking a skill.
  • 05Validates config writes and keeps a backup of the previous file.

Use cases

  • Quickly disabling a noisy or broken OpenCode plugin without editing JSON by hand.
  • Checking which plugins and skills are installed from within the desktop session.
  • Referencing a skill in a prompt by clicking instead of typing its ID.

Quick start

  1. 1

    Install the plugin with the OpenCode CLI

    opencode plugin add opencode-plugin-toggle
  2. 2

    Click the puzzle icon at the right end of the OpenCode desktop session header

Things to know

  • Only toggles plugins in the global config; there is no per-project toggle.
  • Plugin-contributed skills cannot be switched off individually, only the whole plugin can be turned off.

In collections

Topics

FAQ

What is opencode-plugin-toggle?
An OpenCode desktop session-header button to toggle installed plugins on and off and insert @skill mentions into the prompt. opencode-plugin-toggle adds a button to the session header of the OpenCode desktop app. Clicking it opens a popover listing the plugins in your global config, each with a short description and an on/off switch, along with the available skills.
Is opencode-plugin-toggle free to use? What license does it have?
opencode-plugin-toggle is open source under the MIT license. Check the license terms before using it in commercial products.
Is opencode-plugin-toggle still maintained?
Actively maintained. The last commit to opencode-plugin-toggle was on Nov 6, 2026.
What can I use opencode-plugin-toggle for?
Quickly disabling a noisy or broken OpenCode plugin without editing JSON by hand. Checking which plugins and skills are installed from within the desktop session. Referencing a skill in a prompt by clicking instead of typing its ID.
How do I install opencode-plugin-toggle?
Install the plugin with the OpenCode CLI: opencode plugin add opencode-plugin-toggle Click the puzzle icon at the right end of the OpenCode desktop session header
Where can I get opencode-plugin-toggle?
The source code and installation instructions are on GitHub: https://github.com/lay-wang/opencode-plugin-toggle

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects