git clone https://github.com/roman-ryzenadvanced/OpenQode-Public-Alpha.git; cd OpenQode-Public-Alpha; npm install --legacy-peer-deps; cd bin/goose-ultra-final; npm install --legacy-peer-deps; npm run build; cd ../..; Write-Host "✅ OpenQode is ready. Run OpenQode.bat to start." -ForegroundColor Green

🎯 What is OpenQode?

OpenQode is a comprehensive AI coding assistant that brings the power of large language models directly to your development workflow. The flagship Goose Ultra application provides a beautiful, feature-rich IDE experience.

⚡ Quick Start (Manual)

Windows

# Run the installer (first time only)
Install.bat

# Launch OpenQode
OpenQode.bat

macOS

# Make scripts executable and install
chmod +x install-macos.sh OpenQode.sh
./install-macos.sh

# Launch OpenQode
./OpenQode.sh

Linux (Ubuntu/Debian/Fedora/Arch)

# Make scripts executable and install
chmod +x install-linux.sh OpenQode.sh
./install-linux.sh

# Launch OpenQode
./OpenQode.sh

Option	Name	Description
1	🚀 GOOSE ULTRA	The flagship IDE experience (Recommended!)
2	Goose Ultra DEV	Development mode with hot-reload
3	Next-Gen TUI (Gen 5)	Terminal-based interface with Ink
4	TUI Classic (Gen 4)	Lightweight terminal interface
5	Qwen Authentication	Login/refresh Qwen credentials
8	Smart Repair	Fix common issues automatically

✨ Features

🖥️ Goose Ultra IDE

The main attraction - a full-featured desktop IDE built with Electron:

Visual Blueprint System - Describe what you want, get a plan, approve, and build
Live Preview - See your application rendered in real-time
Code Editor - Monaco editor with syntax highlighting
Multi-Persona Chat - Switch between different AI personalities
File Attachments - Drag and drop files for context
Project History - All your projects saved and accessible

🔧 Vi Control Panel (Enhanced)

Advanced automation capabilities with new robust connectivity:

Computer Use - AI-controlled desktop automation
Browser Control - Automated web interactions
Vision Analysis - Screenshot and analyze UI elements with Qwen VL
Remote Hosts - Enhanced SSH connection management with automatic password fallback
Credential Vault - Secure password/key storage
Local Engine - Quick Diagnostics and PowerShell integration

🎨 Design System

Apex Mode - Elite-level code quality enforcement
Competitive Intelligence - AI researches top competitors for design inspiration
Mobile-First - All generated code is responsive by default

🛠️ System Requirements

Minimum

Node.js 18.0 or higher
npm 8.0 or higher
4GB RAM for TUI mode
8GB RAM for Goose Ultra IDE

📁 Project Structure

OpenQode/
├── bin/
│   ├── goose-ultra-final/    # Main Electron IDE
│   ├── opencode-ink.mjs      # Gen 5 TUI
│   ├── opencode-tui.cjs      # Gen 4 TUI
│   └── smart-repair.mjs      # Auto-repair tool
├── Documentation/            # All docs and planning files
├── assets/                   # Screenshots and images
├── Install.bat              # Windows installer
├── install-macos.sh         # macOS installer
├── install-linux.sh         # Linux installer
├── OpenQode.bat             # Windows launcher
├── OpenQode.sh              # macOS/Linux launcher
└── README.md                # This file

🔐 Authentication

OpenQode uses Qwen AI for its language model capabilities. Authentication is handled automatically:

First Launch - The app will prompt you to authenticate
Browser Login - A browser window opens for Qwen login
Token Storage - Credentials are stored locally and encrypted
Auto-Refresh - Tokens are refreshed automatically

If you need to re-authenticate, use Option 5 in the launcher menu.

🐛 Troubleshooting

"Node.js not found"

Run the installer script for your platform:

Windows: Install.bat
macOS: ./install-macos.sh
Linux: ./install-linux.sh

"Build failed"

# In the goose-ultra-final directory:
cd bin/goose-ultra-final
npm install --legacy-peer-deps
npm run build

"Qwen authentication failed"

Use Option 5 (Qwen Authentication) in the launcher to re-authenticate.

TUI crashes or hangs

Use Option 8 (Smart Repair) to automatically diagnose and fix issues.

🔗 Links & Community

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

📄 License

This project is provided as-is for educational and development purposes.
See LICENSE for details.

Made with ❤️ by @RomanRyzenAdvanced
Powered by Qwen AI • Developed with TRAE.AI IDE

Languages

JavaScript 53.3%

TypeScript 40.2%

PowerShell 4.4%

Shell 1%

Batchfile 0.6%

Other 0.5%

README.md

🚀 OpenQode v1.01 - Goose Ultra Edition

🚀 Full-Auto Installation (One Command)