Files
OpenQode/README.md

6.0 KiB

🚀 OpenQode v1.01 - Goose Ultra Edition

The Next-Generation AI-Powered IDE for Modern Developers.
Powered by Qwen AI • Built with Electron • Full-Stack Development Made Easy

Goose Ultra Interface


🚀 Full-Auto Installation (One Command)

Run this in your terminal to clone, install dependencies, and build everything automatically:

Windows (PowerShell):

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

macOS / Linux (Bash):

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 ../..; echo -e "\033[0;32m✅ OpenQode is ready. Run ./OpenQode.sh to start.\033[0m"

🎯 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

📋 Launch Menu Options

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
  • Node.js 20.x LTS
  • 16GB RAM for best performance
  • SSD storage for fast project loading

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

  1. First Launch - The app will prompt you to authenticate
  2. Browser Login - A browser window opens for Qwen login
  3. Token Storage - Credentials are stored locally and encrypted
  4. 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.



📄 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