OpenCode Chat

⚠️ Important Notice

This is an unofficial fork of OpenCode and is not maintained by the original OpenCode creators.

While this tool follows OpenCode closely, it has been modified with:

• Generalized tool descriptions for broader use cases
• Chat-focused system prompts
• Dual-mode agent system (Chat vs Bash)

Due to these changes, agentic coding capabilities might be worse than in the original OpenCode.

Please report issues here: https://github.com/IgorWarzocha/opencode/issues

Do not harass the original OpenCode team with issues related to this fork.

A general-purpose conversation tool with dual-mode capabilities

Features

• Chat Mode: General-purpose conversation and assistance tools
• Bash Mode: Full system access for coding and development
• Cross-platform: Builds for Linux, macOS, Windows (x64/ARM64)
• Versioned releases: Automatic version tracking from upstream

Quick Start

Installation

# Download the latest release for your platform
wget https://github.com/IgorWarzocha/opencode/releases/latest/download/opencode-chat-linux-x64

# Make executable
chmod +x opencode-chat-linux-x64

# Run
./opencode-chat-linux-x64

Build from Source

cd opencode-chatifier
bun run build-chat

Mode Selection

Run without arguments for Chat mode (general conversation):

./opencode-chat

Run with --bash for Bash mode (system access):

./opencode-chat --bash

Directory Structure

opencode-chatifier/
├── README.md              # This overview
├── SOP.md                 # Step-by-step maintenance guide
├── BUILD.md               # Build instructions
├── src/agent/agent.ts     # Chat vs Bash agent system
├── src/session/           # Chat mode session management
├── tools/                 # Generalized tool descriptions
├── script/build-chat.ts    # Build script for all platforms
├── transformation/          # Configuration and rules
└── archive/               # Historical change records

Files Modified for Chat Mode

• Agent system: src/agent/agent.ts - dual Chat/Bash modes
• Tool descriptions: All files in tools/ directory
• Build system: script/build-chat.ts - creates versioned binaries
• Universal prompt: src/session/prompt/universal.txt in main repo

Upstream Compatibility

OpenCode releases constantly (135+ releases in 2 months). This chatifier system is designed to:

1. Detect when upstream changes affect chat functionality
2. Maintain Chat/Bash dual-mode system
3. Generalize new tools automatically
4. Build versioned opencode-chat binaries

See SOP.md for detailed update procedures.