🚀 OpenQode Public (GEN5 TUI Included!)
The Next-Generation AI Coding Assistant for your Terminal. Powered by Qwen & OpenCode. ! [Initial fork of OpenCode with Qwen Code model access developed with TRAE.AI IDE and GLM 4.6 coding model
👋 Welcome to OpenQode
OpenQode is a powerful Terminal User Interface (TUI) that brings advanced AI coding capabilities directly to your command line. Whether you're debugging via SSH, coding on a cloud server, or just love the terminal, OpenQode is designed for you.
⚡ 1-Click Installation (Zero-Config)
🖥️ Windows (PowerShell)
Copy and paste this into PowerShell:
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/roman-ryzenadvanced/OpenQode-Public-Alpha/main/install.ps1'))
🍎 macOS / 🐧 Linux (Bash)
Copy and paste this into your terminal:
curl -sL https://raw.githubusercontent.com/roman-ryzenadvanced/OpenQode-Public-Alpha/main/install.sh | bash
(These scripts automatically download source, install dependencies, and launch the assistant)
📦 Manual Installation
Windows
- Download the latest release.
- Double-click
OpenQode.bat. (First run will automatically install dependencies)
Linux / Mac
- Open terminal in the folder.
- Run:
chmod +x OpenQode.sh ./OpenQode.sh
📋 Launcher Menu Options
When you launch OpenQode, you'll see a menu with several options. Here's what each one does:
🏠 In-House Developed TUIs (Recommended)
These are custom-built TUIs developed specifically for OpenQode:
| Option | Name | Description |
|---|---|---|
| 5 | ★ Next-Gen TUI (Gen 5) | 🌟 Recommended! Full dashboard with split panes, animated borders, RGB visuals, interactive menus, streaming responses, and all intelligent features (SmartX, AutoRun, etc.) |
| 4 | TUI Classic (Gen 4) | Lightweight single-stream interface. Good for low-resource terminals or simple tasks. |
🔧 CLI Tools (Third-Party)
Standard CLI tools that work alongside OpenQode:
| Option | Name | Description |
|---|---|---|
| 2 | Qwen TUI (CLI) | Uses the official qwen CLI. Requires npm install -g @qwen-code/qwen-code |
| 3 | OpenCode TUI (Windows) | Windows-native opencode.exe binary. Windows only. |
🌐 Web-Based Tools (Early Development)
⚠️ Community Contributions Welcome! These tools are in early development and not actively maintained. If you're interested in contributing, feel free to fork and improve!
| Option | Name | Description |
|---|---|---|
| 1 | Web GUI | Browser-based interface at http://localhost:15044 |
| 7 | Web Assist Dashboard | Assistance dashboard (Windows: Option 7, Linux: N/A) |
| 8 | Web IDE | Alpha web-based IDE (Windows: Option 8, Linux: N/A) |
🛠️ Utilities
| Option | Name | Description |
|---|---|---|
| 6 | Agent Manager | Manage AI agents (Windows only, or edit files manually) |
| 9 / 7 | 🔧 Smart Repair | AI-powered TUI self-healing. Diagnose and fix crashes automatically. |
| 0 / 8 | Exit | Close the launcher |
🆚 Which Version Should I Use?
We recommend starting with Next-Gen (Option 5)!
| Feature | 🌟 Next-Gen TUI (Gen 5) | 🕰️ Classic TUI (Gen 4) |
|---|---|---|
| Best For | Modern Experience | Low-Resource / Simple |
| Interface | Full Dashboard with Split Panes | Single Scrolling Stream |
| Visuals | Animated Borders, RGB Pulse, Spinners | Static Text |
| Interactivity | Interactive Menus (Arrow Keys Selection) | Command-based only |
| Computer Use | Command Execution (Runs shell cmds) | Read-only |
| SmartX Engine | Autonomous Operation (Auto-heal, auto-execute) | N/A |
| Auto-Approve | AutoRun Commands without Y/N prompts | N/A |
| Projects | Any Absolute Path (e.g. E:\MyProject) | Subfolders Only |
| Models | Visual Model Selector (/model) |
Manual Switch via CLI |
| Thinking | Real-time Stats (CPS, Tokens) | Basic Loading |
🧠 Intelligent Features
OpenQode Gen 5 introduces a powerful suite of intelligent automation features designed for maximum productivity:
🔀 Multi-Agent Mode (/agents)
Enables dynamic multi-agent orchestration. The AI intelligently selects and coordinates specialized agents based on your project's requirements—from code generation to debugging, testing, and documentation—all working in concert.
🧩 Smart Context (/context)
Persistent context sharing across agents and sessions. Your conversation history, project state, and decisions are preserved—even after restarting the TUI. Multiple agents can seamlessly share context for coherent, continuous collaboration.
💭 Exposed Thinking (/thinking)
Transparency mode that reveals the AI's reasoning process in real-time. Watch as the agent analyzes problems, considers alternatives, and formulates solutions—giving you insight into every decision.
🚀 SmartX Engine (/smartx)
Autonomous error-recovery mode. When enabled, the AI will automatically retry and heal from errors rather than stopping to ask for input. Failed commands, broken builds, and runtime errors are diagnosed and fixed in a continuous loop until resolved.
⚡ AutoRun (/auto)
System-level autonomous execution. An extension of SmartX that grants the AI permission to perform file operations, run shell commands, and manage server tasks without requiring manual approval. Perfect for hands-free automation workflows.
💡 Pro Tip: Combine SmartX + AutoRun for fully autonomous coding sessions. Press
ESCat any time to abort!
🔧 Smart Repair Agent v2.0
When your TUI crashes or encounters errors, Smart Repair is an AI-powered self-healing system that diagnoses and fixes issues automatically.
What It Does:
- Analyze Errors - Paste any crash/error message
- AI Diagnosis - Identifies root cause using Qwen AI models
- Auto-Fix - Runs repair commands (
npm install,git pull, etc.) - Verify - Checks if the fix was successful
How to Access:
| Platform | Menu Option |
|---|---|
| Windows | OpenQode.bat → Option 9 |
| Linux/Mac | ./OpenQode.sh → Option 7 |
| Direct | node bin/smart-repair.mjs |
Commands Inside Smart Repair:
- Paste error → AI analyzes and suggests fix
model→ Switch AI model (Coder Plus, Plus, Turbo)auth→ Trigger Qwen authenticationquit→ Exit
⚡ Feature: Zero-Config Authentication
OpenQode attempts to use your existing Qwen CLI authentication.
- Using standard Option 5, simply follow the prompts.
- If it's your first time, you may need to authenticate via browser.
- The assistant is designed to be "Hassle Free"!
🔑 Advanced Configuration
If you have your own API keys or specialized setup:
- Copy
config.example.cjstoconfig.cjs. - Edit
config.cjsto add your keys.
🔗 Links & Community
- GitHub: roman-ryzenadvanced/OpenQode-Public-Alpha
- Telegram: @openqode
- Discord: Join Community
Made with ❤️ by @RomanRyzenAdvanced