OpenQode/README.md

🚀 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

1. Download the latest release.
2. Double-click OpenQode.bat. (First run will automatically install dependencies)

Linux / Mac

1. Open terminal in the folder.
2. Run:

   chmod +x OpenQode.sh
   ./OpenQode.sh
   

---

🆚 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 ESC at any time to abort!

---

⚡ 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:

1. Copy config.example.cjs to config.cjs.
2. Edit config.cjs to add your keys.

---

🔗 Links & Community

• GitHub: roman-ryzenadvanced/OpenQode-Public-Alpha
• Telegram: @openqode
• Discord: Join Community

Made with ❤️ by @RomanRyzenAdvanced