Pi-Harness v1.0.8

The complete local-first desktop harness for Pi Coding Agent.

Author: wangmiao · tuziling84@gmail.com
Repository: https://github.com/wangmiaozero/pi-harness
License: GNU AGPL v3.0 only (AGPL-3.0-only)

English · 简体中文 · 한국어 · Русский · Français · Deutsch

---

English

v1.0.8 makes provider setup fast and predictable: choose a provider, choose a Pi-compatible model, enter the API key, and save. Protocol, endpoint, authentication mode, and model metadata are prefilled but remain fully editable.

Downloads

Platform	File
macOS Apple Silicon	Pi-Harness-1.0.8-arm64.dmg
macOS Intel	Pi-Harness-1.0.8.dmg
Windows x64	Pi-Harness Setup 1.0.8.exe
Linux x64	Pi-Harness-1.0.8.AppImage

macOS builds are unsigned. On first launch, use System Settings → Privacy & Security → Open Anyway, or run:

xattr -cr /Applications/Pi-Harness.app

### Highlights

- Searchable presets for **54 providers and 2,478 Pi-compatible text/code models**, generated from the local AgentDesk and WangmiaoGit-p catalogs.
- Provider and model selection automatically fills the provider key, name, Pi protocol, API base URL, authentication mode, and default model.
- Only the selected model is registered in Pi `models.json`; its name, context window, and maximum output-token metadata are retained when available.
- The Models form reuses the same provider catalog and still accepts arbitrary custom model IDs.
- Provider dialogs no longer close on backdrop clicks or Escape, preventing accidental loss of long-form edits.
- Electron native menus now follow the active light/dark theme.
- Refined Session selection with a compact accent indicator and better spacing.
- `APP_VERSION` now comes directly from `package.json`, eliminating duplicated release-version state.

### Requirements

- [Pi Coding Agent](https://github.com/badlogic/pi-mono), or install/update it from Pi-Harness
- From source: Node.js ≥ 22 and pnpm `9.12.1`

---

## 简体中文

v1.0.8 让提供商配置变成清晰的一条路径：选择厂商、选择符合 Pi 的模型、填写 API Key、保存。协议、端点、鉴权方式和模型参数会自动填写，同时继续允许用户修改所有字段。

### 下载

| 平台                | 文件                         |
| ------------------- | ---------------------------- |
| macOS Apple Silicon | `Pi-Harness-1.0.8-arm64.dmg` |
| macOS Intel         | `Pi-Harness-1.0.8.dmg`       |
| Windows x64         | `Pi-Harness Setup 1.0.8.exe` |
| Linux x64           | `Pi-Harness-1.0.8.AppImage`  |

macOS 安装包**未签名**。首次打开时使用“系统设置 → 隐私与安全性 → 仍要打开”，或执行：

```bash
xattr -cr /Applications/Pi-Harness.app
```

### 主要更新

- 新增可搜索预设：**54 个厂商、2478 个符合 Pi 的文本/代码模型**，由本地 AgentDesk 与 WangmiaoGit-p 目录生成。
- 选择厂商和模型后自动填写提供商标识、名称、Pi 协议、API Base URL、鉴权方式和默认模型。
- 只把用户选中的模型注册到 Pi `models.json`；目录有数据时同步保存名称、上下文窗口和最大输出 Token。
- 模型页面复用同一厂商目录，同时继续允许输入任意自定义模型 ID。
- 提供商弹窗不再因点击遮罩或按 Escape 误关闭，长表单编辑更安全。
- Electron 原生菜单跟随应用深色/浅色主题。
- Session 选中态改为更轻量的强调圆点与文字，改善与上方项目行的间距。
- `APP_VERSION` 直接读取 `package.json`，发布版本不再维护两份。

### 环境要求

- [Pi Coding Agent](https://github.com/badlogic/pi-mono)，也可以在 Pi-Harness 内安装或更新
- 从源码构建：Node.js ≥ 22，pnpm `9.12.1`

---

## 한국어

v1.0.8에서는 공급자와 Pi 호환 모델을 선택한 뒤 API 키만 입력하면 됩니다. 프로토콜, API 주소, 인증 방식 및 모델 메타데이터가 자동으로 채워지며 모든 필드는 계속 수정할 수 있습니다.

### 주요 변경 사항

- 54개 공급자와 2,478개 Pi 호환 텍스트/코드 모델을 제공하는 검색 가능한 프리셋
- 선택한 모델만 Pi `models.json`에 등록하고 가능한 경우 이름, 컨텍스트 및 최대 출력 토큰을 보존
- 공급자 대화상자의 배경 클릭 및 Escape 자동 닫기 방지
- 라이트/다크 테마를 따르는 Electron 네이티브 메뉴
- 개선된 Session 선택 표시 및 단일 `package.json` 버전 소스

---

## Русский

В v1.0.8 достаточно выбрать провайдера и совместимую с Pi модель, затем ввести API-ключ. Протокол, URL API, режим аутентификации и параметры модели заполняются автоматически, но остаются редактируемыми.

### Основные изменения

- Поисковый каталог из 54 провайдеров и 2 478 текстовых/кодовых моделей, совместимых с Pi
- Регистрация только выбранной модели в Pi `models.json` с сохранением доступных метаданных
- Защита диалога провайдера от случайного закрытия по фону или Escape
- Нативные меню Electron следуют светлой/тёмной теме
- Улучшенное выделение Session и единый источник версии в `package.json`

---

## Français

Avec v1.0.8, sélectionnez un fournisseur et un modèle compatible Pi, puis saisissez uniquement la clé API. Le protocole, l’URL, l’authentification et les métadonnées sont préremplis tout en restant modifiables.

### Points clés

- Catalogue recherchable de 54 fournisseurs et 2 478 modèles texte/code compatibles Pi
- Seul le modèle sélectionné est enregistré dans Pi `models.json`, avec ses métadonnées disponibles
- Protection des dialogues fournisseur contre la fermeture accidentelle par le fond ou Escape
- Menus Electron natifs synchronisés avec le thème clair/sombre
- Sélection de Session affinée et version centralisée dans `package.json`

---

## Deutsch

In v1.0.8 wählen Sie einen Anbieter und ein Pi-kompatibles Modell aus und tragen nur noch den API-Schlüssel ein. Protokoll, API-URL, Authentifizierung und Modelldaten werden vorausgefüllt und bleiben vollständig editierbar.

### Highlights

- Durchsuchbarer Katalog mit 54 Anbietern und 2.478 Pi-kompatiblen Text-/Code-Modellen
- Nur das ausgewählte Modell wird inklusive verfügbarer Metadaten in Pi `models.json` registriert
- Schutz des Anbieter-Dialogs vor versehentlichem Schließen durch Hintergrundklick oder Escape
- Native Electron-Menüs folgen dem Hell-/Dunkel-Theme
- Verfeinerte Session-Auswahl und zentrale Versionsquelle in `package.json`

---

**Full changelog:** https://github.com/wangmiaozero/pi-harness/compare/v1.0.7...v1.0.8