koopticon

🎉 opencode-bas-plugin - Enhance Your Collaboration Experience

🚀 Getting Started

To enhance your collaborative work in technical discussions, follow these steps to download and set up the OpenCode Behavior Adjustment System (BAS) Plugin.

📥 Download & Install

Visit the Releases page to find the latest version of the plugin.
Download the appropriate file for your operating system. Make sure to choose the correct version based on your setup (Windows, macOS, or Linux).
Follow the installation instructions for your operating system:
- Windows: Simply run the downloaded .exe file and follow the prompts.
- macOS: Open the downloaded file and drag the plugin to your Applications folder.
- Linux: Use your package manager or unzip the downloaded file and run the command: ./install.sh.

Once installed, the plugin will enhance your technical conversations.

⚙️ Configuration

To personalize your experience, you can adjust the plugin’s settings. It loads configurations from two locations:

User-level Configuration:
- File Path: ~/.config/opencode/behavior-config.json
Project-level Configuration:
- File Path: .opencode/behavior-config.json

The project-level configuration will override the user-level settings when both are present.

📝 Example `behavior-config.json`

You can create or modify your behavior-config.json file with the following sample settings:

{
  "enabled": true,           // Global toggle for the plugin
  "topics": [
    "Code Review",
    "Architecture",
    "Debugging"
  ],
  "reminderRate": 5,       // Reminders every 5 minutes
  "logEvents": true         // Enable detailed logging
}

✨ Features

The OpenCode BAS Plugin offers several key features to streamline your collaboration:

Contextual Awareness: The plugin detects conversation topics, such as Code Review and Architecture. It then applies relevant reminders tailored to the topic.
Adaptive Model Parameters: The plugin adjusts its behavior based on the context of the discussion, improving its effectiveness.
Template Deduplication: When multiple contexts match, the plugin prioritizes which reminder to inject, preventing repetition.
Configurable Injection Rates: You control how often reminders appear, ensuring they support rather than disrupt the conversation.
Detailed Logging: Optionally, log your reminder events for later analysis to understand how the plugin assists in your discussions.

📊 Understanding Context Detection

The plugin identifies various conversation themes:

Code Review: Offers prompts to keep feedback constructive.
Architecture: Provides reminders to discuss foundational design principles.
Debugging: Encourages users to ask questions related to troubleshooting processes.

By tailoring these reminders, the plugin supports focused discussions.

🔍 Troubleshooting

If you encounter issues while using the plugin, here are some common problems and solutions:

Plugin Doesn’t Start:
- Ensure you installed it properly.
- Check if your configuration file has valid JSON syntax.
Reminders Aren’t Appearing:
- Confirm that the plugin is enabled in your configuration file.
- Adjust the reminder rate to a shorter time frame.
Installation Errors:
- Verify that you downloaded the correct version for your operating system.

If your issues persist, consider consulting the issues page to report new problems or find solutions from other users.

📢 Community and Support

Join our community to ask questions and share experiences:

Connect with other users to get tips and advice on maximizing the plugin’s potential.

🛠️ Contribution

We welcome contributions from anyone interested in improving the OpenCode BAS Plugin. If you have suggestions or your own enhancements, please follow the guidelines in the CONTRIBUTING.md file.

For quick recommendations and testing, see our documentation on adding features and resolving bugs effectively.

📎 Important Links

This guide should help you effectively download and set up the OpenCode BAS Plugin, enhancing your collaboration tools during technical discussions.