# Solo Trae Desktop Installers

### Code Mode
![Solo in Code Mode](assets/windows-screenshot.png)

This repository contains native desktop installers for **Solo Trae** (https://solo.trae.ai) on both **Windows** and **Linux**.

### Work Mode
![Solo in Work Mode](assets/linux-screenshot.png)

The installers are built using a wrapper around the official Electron runtime and bundled with a Go-based self-extracting deployment tool. They provide a seamless native application experience without requiring standard browsers or manual configuration.

## Files Provided

### 1. `SoloInstaller.exe` (Windows)
A completely silent, self-extracting native installer for Windows (x64).
- **How to Use:** Download and double-click `SoloInstaller.exe`.
- **What it Does:**
  - Extracts the pre-configured Electron app silently to your `%APPDATA%\SoloApp` directory.
  - Automatically creates a desktop shortcut (`Solo.lnk`).
  - Immediately launches the Solo application.

### 2. `SoloInstaller-Linux` (Linux)
A native executable installer for Linux (x64).
- **How to Use:** 
  1. Download the file.
  2. Make it executable: `chmod +x SoloInstaller-Linux`
  3. Run it: `./SoloInstaller-Linux`
- **What it Does:**
  - Extracts the Linux Electron app silently to your `~/.config/SoloAppLinux` (or a fallback temp directory).
  - Sets the correct execution permissions.
  - Creates a `.desktop` shortcut on your Desktop for easy access.
  - Launches the Solo application.

## Development Details

- **Runtime:** Built around Electron v41.1.1
- **Packaging:** Bundled using Go `embed` to bypass traditional deployment toolchain limitations (like Wine).
- **Silent Mode:** Installers execute completely in the background without requiring user interaction (No Next/Finish wizards).

## OpenClaw Automated Self-Healing Engine

Included in this repository is `openclaw-healer.sh`, a robust background daemon script designed to mitigate headless browser crashes and port deadlocks commonly encountered when automating OpenClaw or Puppeteer.

### What it does:
1. **Zombie Reaping:** Continuously scans for and aggressively reaps `[Z] Defunct` instances of Chrome, Chromium, and Puppeteer by terminating their deadlocked parent processes.
2. **Port Mitigation:** Monitors target ports (default `18800`) for stalled processes. If a process holds the port for longer than 120 seconds, the healer executes a forced termination (`kill -15` then `kill -9`) to guarantee the port is released for the next automation task.

### How to run it:
```bash
chmod +x openclaw-healer.sh
nohup bash -c "while true; do ./openclaw-healer.sh; sleep 60; done" > /var/log/openclaw-healer.log 2>&1 &
```