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
npx @wzrddev/opencode-remi@latestnpm install @wzrddev/opencode-remicurl -s https://raw.githubusercontent.com/mdthewzrd/opencodewzrd/main/install.sh | bashRemi 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 |
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
- Seamless integration with OpenCode editor
- Context-aware responses
- Workspace integration
- File operations support
# 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 setupOnce installed, Remi integrates directly with OpenCode:
- Open any project in OpenCode
- Use the command palette:
Cmd/Ctrl + Shift + P - Type "Remi" to access WZRD.dev commands
- Ask questions directly in the editor
# 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...wzrd setupThis creates ~/.wzrd/config.json with:
{
"autoModeDetection": true,
"skillDirectory": "./skills",
"logLevel": "info",
"maxResponseLength": 5000,
"enableSkills": true
}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"
}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
- Node.js 16+
- OpenCode 1.0+
- TypeScript 5.0+
# 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- Create skill file in
example-skills/ - Run
npm run build:skillsto bundle - Skills will be included in distribution
We welcome contributions! Please see CONTRIBUTING.md for details.
- Add new skill JSON files
- Improve existing skills
- Update documentation
- Report issues
MIT © WZRD.dev
Having issues? Check:
- OpenCode Compatibility: Ensure OpenCode >= 1.0.0
- Node.js Version: Requires Node.js >= 16.0.0
- Permissions: Check OpenCode extension permissions
- 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