docs: add plugins and plugins_override toggle documentation

[geq1fan]

Summary

• Add documentation for the plugins toggle option in claude_code config
• Add documentation for the plugins_override option to selectively disable specific plugins
• Update the compatibility toggles table to include the new plugins option

Problem

The plugins and plugins_override configuration options were supported by the codebase but not documented in the README. Users had no way to know how to:

1. Disable all Claude Code marketplace plugins
2. Selectively disable specific plugins while keeping others enabled

Solution

Added the missing documentation to the "Compatibility Toggles" section, including:

• The plugins: false option in the example JSON
• A new row in the toggles table explaining what plugins controls
• A new section showing how to use plugins_override with specific plugin identifiers

Testing

Documentation-only change, no code changes.

---

Summary by cubic

Adds documentation for the plugins and plugins_override options in the claude_code config so users can disable all marketplace plugins or selectively turn off specific ones. Updates the compatibility toggles table and example JSON to include plugins.

^{Written for commit c7e05ee. Summary will update on new commits.}

[github-actions]

All contributors have signed the CLA. Thank you! ✅
_{Posted by the CLA Assistant Lite bot.}

[greptile-apps]

Greptile Summary

This PR adds documentation for the plugins and plugins_override configuration options in the Compatibility Toggles section of README.md. The documentation accurately reflects the implemented features that were previously undocumented. Changes include:

• Added "plugins": false to the example JSON configuration
• Added a new table row explaining the plugins toggle and its behavior
• Added a new subsection showing usage examples of plugins_override with full plugin identifiers

The documentation is clear and provides practical examples for users who want to disable Claude Code marketplace plugins entirely or selectively disable specific plugins. This addresses the documentation gap identified in the PR description.

Confidence Score: 5/5

• This PR is safe to merge with no issues. It's a pure documentation update that accurately reflects existing, implemented features.
• Score is 5 because: (1) this is a documentation-only change with no code modifications, (2) the documented features are verified to exist in the codebase (plugins boolean and plugins_override record in the schema and config handler), (3) the documentation is clear, accurate, and provides practical examples, (4) the changes follow the existing documentation style and structure, (5) there are no breaking changes or compatibility concerns.
• No files require special attention

Important Files Changed

Filename

Overview

README.md

Documentation for plugins and plugins_override configuration options added to the Compatibility Toggles section. Changes add example JSON configuration and a table entry explaining the plugins toggle, plus a new section with code example for plugins_override. Documentation accurately reflects the implemented feature (verified in src/config/schema.ts lines 121-122 and src/plugin-handlers/config-handler.ts lines 67-70).

Sequence Diagram

sequenceDiagram
    participant User
    participant OpenCode
    participant ConfigHandler
    participant PluginLoader

    User->>OpenCode: Start OpenCode session
    OpenCode->>ConfigHandler: Load configuration (oh-my-opencode.json)
    ConfigHandler->>ConfigHandler: Check claude_code.plugins setting
    
    alt plugins: false
        ConfigHandler->>ConfigHandler: Return empty plugin components
    else plugins: true (default)
        ConfigHandler->>PluginLoader: Load plugin components
        PluginLoader->>PluginLoader: Check plugins_override settings
        
        alt plugins_override configured
            PluginLoader->>PluginLoader: Filter disabled plugins by identifier
            PluginLoader->>ConfigHandler: Return filtered plugins
        else no overrides
            PluginLoader->>ConfigHandler: Return all plugins
        end
    end
    
    ConfigHandler->>OpenCode: Plugins configured
    OpenCode->>User: Session ready with plugins applied

Loading

[greptile-apps]

Greptile found no issues!

From now on, if a review finishes and we haven't found any issues, we will not post anything, but you can confirm that we reviewed your changes in the status check section.

_{This feature can be toggled off in your Code Review Settings by deselecting "Create a status check for each PR".}

[cubic-dev-ai]

No issues found across 1 file

Confidence score: 5/5

• Automated review surfaced no issues in the provided summaries.
• No files require special attention.

[geq1fan]

I have read the CLA Document and I hereby sign the CLA