opencode-wzrd
TypeScript icon, indicating that this package has built-in type declarations

2.0.0 • Public • Published

WZRD.dev OpenCode Extension

WZRD.dev OpenCode Version License

Remi: The WZRD.dev agent with auto-mode detection for OpenCode.

Transform your OpenCode experience with Remi, an AI assistant that automatically detects task types and switches between 5 specialized modes:

  • CHAT MODE: Casual conversation, simple questions
  • CODER MODE: Code generation, implementation
  • THINKER MODE: Architecture, planning, design
  • DEBUG MODE: Error fixing, problem solving
  • RESEARCH MODE: Deep investigation, comprehensive analysis

🚀 Quick Start

One-Line Installation

npx @wzrddev/opencode-remi@latest

Manual Installation

npm install @wzrddev/opencode-remi

Script Installation

curl -s https://raw.githubusercontent.com/mdthewzrd/opencodewzrd/main/install.sh | bash

📦 Features

Auto-Mode Detection

Remi automatically detects which mode to use based on your input:

Trigger Mode
"Hi", casual talk CHAT
"Write code", "function" CODER
"Design", "plan", "architecture" THINKER
"Error", "bug", "broken" DEBUG
"Research", "compare", "analyze" RESEARCH

180+ Built-in Skills

Access specialized skills for every task:

  • Coding: All languages and frameworks
  • Debugging: Error analysis and fixes
  • Architecture: System design and planning
  • Research: Comprehensive investigation
  • Automation: Task scheduling and workflows
  • Security: Auditing and best practices

OpenCode Integration

  • Seamless integration with OpenCode editor
  • Context-aware responses
  • Workspace integration
  • File operations support

🎯 Usage

CLI Commands

# Start interactive session
wzrd chat "Write a Python function to calculate Fibonacci"

# List available modes
wzrd modes

# Show loaded skills
wzrd skills

# Setup configuration
wzrd setup

OpenCode Integration

Once installed, Remi integrates directly with OpenCode:

  1. Open any project in OpenCode
  2. Use the command palette: Cmd/Ctrl + Shift + P
  3. Type "Remi" to access WZRD.dev commands
  4. Ask questions directly in the editor

Examples

# CODER MODE example
$ wzrd chat "Write a React component that displays a counter"
[CODER MODE]
I'll help you write code...

# THINKER MODE example  
$ wzrd chat "Design a database schema for an e-commerce site"
[THINKER MODE]
I'll help you design and plan...

# DEBUG MODE example
$ wzrd chat "I'm getting 'undefined is not a function' error"
[DEBUG MODE]
I'll help you debug...

🔧 Configuration

Setup Configuration

wzrd setup

This creates ~/.wzrd/config.json with:

{
  "autoModeDetection": true,
  "skillDirectory": "./skills",
  "logLevel": "info",
  "maxResponseLength": 5000,
  "enableSkills": true
}

Custom Skills

Add custom skills to ~/.wzrd/skills/:

{
  "name": "my-custom-skill",
  "description": "My custom skill",
  "modes": ["CODER", "THINKER"],
  "instructions": "Help with my specific tasks",
  "examples": ["Do my thing", "Help with that"],
  "tags": ["custom", "special"],
  "version": "1.0.0"
}

📁 Project Structure

opencodewzrd/
├── src/
│   ├── index.ts          # Main entry point
│   ├── agent.ts          # Core agent with mode detection
│   ├── cli.ts            # Command line interface
│   └── types.ts          # Type definitions
├── skills/               # Bundled skills
├── dist/                 # Compiled output
├── scripts/
│   └── bundle-skills.js  # Skill bundling script
├── test/                 # Test files
├── package.json          # NPM package config
├── tsconfig.json        # TypeScript config
└── README.md            # This file

🛠️ Development

Prerequisites

  • Node.js 16+
  • OpenCode 1.0+
  • TypeScript 5.0+

Build from Source

# Clone repository
git clone https://github.com/mdthewzrd/opencodewzrd.git
cd opencodewzrd

# Install dependencies
npm install

# Build package
npm run build

# Test locally
npm test

Adding New Skills

  1. Create skill file in example-skills/
  2. Run npm run build:skills to bundle
  3. Skills will be included in distribution

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

Skill Contributions

  • Add new skill JSON files
  • Improve existing skills
  • Update documentation
  • Report issues

📄 License

MIT © WZRD.dev

🔗 Links

🆘 Support

Having issues? Check:

  1. OpenCode Compatibility: Ensure OpenCode >= 1.0.0
  2. Node.js Version: Requires Node.js >= 16.0.0
  3. Permissions: Check OpenCode extension permissions
  4. Network: Skills require internet for initial download

Create an issue on GitHub for bugs or feature requests.


"Good architecture is invisible. Bad architecture is impossible to ignore." - Remi, WZRD.dev Agent