# 🚀 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](assets/screenshots/goose-ultra-interface.png)

---

## 🚀 Full-Auto Installation (One Command)

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

**Windows (PowerShell):**
```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):**
```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
```batch
# Run the installer (first time only)
Install.bat

# Launch OpenQode
OpenQode.bat
```

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

# Launch OpenQode
./OpenQode.sh
```

### Linux (Ubuntu/Debian/Fedora/Arch)
```bash
# 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:

![Game Dev Mode](assets/screenshots/goose-ultra-game-dev.png)

- **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

### Recommended
- **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"
```bash
# 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](https://github.com/roman-ryzenadvanced/OpenQode-Public-Alpha)
- **Telegram:** [@openqode](https://t.me/VibeCodePrompterSystem)
- **Discord:** [Join Community](https://discord.gg/2nnMGB9Jdt)

---

## 📄 License

This project is provided as-is for educational and development purposes.  
See [LICENSE](LICENSE) for details.

---

*Made with ❤️ by @RomanRyzenAdvanced*  
*Powered by Qwen AI • Developed with [TRAE.AI IDE](https://www.trae.ai/)*
