Skip to content

Pi-Harness v1.1.0

Choose a tag to compare

View all tags
@wangmiaozero wangmiaozero released this 24 Aug 14:29
· 18 commits to main since this release
v1.1.0
5ef2521

The complete local-first desktop control plane and native workspace 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

Pi-Harness v1.1.0 adds one-click Node.js/Pi environment bootstrap, a unified Capability and Package lifecycle, 29 bundled Matt Pocock Skills, and a runtime-driven 13-state mascot layer.

Downloads

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

macOS builds are unsigned unless a signing identity was supplied during packaging. On first launch, use System Settings → Privacy & Security → Open Anyway, or run:

xattr -cr /Applications/Pi-Harness.app

Highlights

  • One-click environment bootstrap: detects or installs Node.js 22+, repairs npm's user prefix and login-shell PATH, installs Pi Coding Agent, streams progress and logs, supports cancellation/retry, and verifies the final pi --version result.
  • Managed Node runtime: downloads a current supported Node.js LTS from the official distribution service, verifies SHA-256 checksums, installs under a dedicated user directory with atomic rollback, and never downgrades an existing supported runtime.
  • Unified Capability Layer: Skills, Extensions, Packages, MCP entries, and Presets share one domain model while Pi Coding Agent remains the only Agent Runtime.
  • Featured Skill lifecycle: Odai is available as an ordinary trusted-catalog Skill with validated install, update, enable/disable, refresh, backup, and uninstall flows.
  • Package reconciliation and repair: global/project npm, git, and local packages are classified as healthy, missing, orphaned, permission-error, corrupted, or unknown, with verified repair, re-register, reinstall, orphan cleanup, and thorough uninstall actions.
  • Every Skill can be removed safely: standalone and user-authored Skills are backed up before deletion; Package-provided Skills uninstall their owning Package instead of corrupting one child resource.
  • 29 bundled Matt Pocock Skills: offline global/project installation, exact ownership, content hashes, conflict and local-modification detection, individual/batch uninstall, update, and reinstall.
  • Runtime-driven mascots: all six themes observe Pi runtime events through a read-only adapter and expose 13 states for thinking, running, coding, tools, waiting, review, completion, failure, warning, greeting, celebration, and sleep.
  • Status speech bubble: Workspace mascots now show live task text above the character, including durable completion and failure states plus tool-specific activity such as coding, shell, Git, browser, search, filesystem, Skills, Packages, and Extensions.
  • Mascot privacy gate: mascot controls are collapsed and locked by default. The Main process prevents renderer-side bypass before the built-in knowledge challenge is completed.

Reliability and security

  • Renderer mutations submit only typed, validated identifiers and structured targets. Main derives trusted sources, commands, install paths, and delete paths.
  • Environment and package commands use fixed executable/argument arrays. npm permission repair never invokes sudo.
  • Node downloads require official checksums; replacement is limited to the dedicated managed runtime root with staging and rollback.
  • Skill updates, replacements, and removals are backup-first and constrained by lexical plus real-path checks. External symlink targets are excluded.
  • Package startup preflight blocks Agent sessions when registered packages are missing, corrupted, or inaccessible instead of silently masking the problem.
  • Provider enablement is normalized to at most one provider; stale refresh responses and concurrent UI toggles cannot display every provider as enabled.

Upgrade notes

  • Existing healthy Node.js 22+ and Pi installations are reused and never downgraded.
  • Mascots remain off by default. Existing invalid or locked settings resolve to “No Mascot”; completion sound remains off by default.
  • If a registered Pi Package is unhealthy, open Skills → Packages to repair or thoroughly uninstall it before starting a new Agent session.
  • Pi-Harness remains a lightweight editor and desktop control plane. It does not add another Agent Runtime, terminal, debugger, LSP, or IDE extension host.

Requirements

  • Packaged application: Pi Coding Agent can be installed or repaired from Pi-Harness
  • From source: Node.js ≥ 22 and pnpm 9.12.1

简体中文

Pi-Harness v1.1.0 新增 Node.js/Pi 一键环境引导、统一 Capability 与 Package 生命周期、29 个内置 Matt Pocock Skills，以及由 Pi Runtime 事件驱动的 13 状态看板娘系统。

下载

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

macOS 构建未提供签名证书时安装包为未签名。首次打开请使用“系统设置 → 隐私与安全性 → 仍要打开”，或执行：

xattr -cr /Applications/Pi-Harness.app

主要更新

  • 一键安装环境： 自动检测或安装 Node.js 22+，修复 npm 用户级 prefix 与 login-shell PATH，安装 Pi Coding Agent，实时显示进度/日志，支持取消、重试，并最终执行 pi --version 验证。
  • 受管 Node Runtime： 从 Node.js 官方分发服务选择当前平台可用的较新 LTS，校验 SHA-256 后安装到独立用户目录；使用 staging、原子替换和回滚，不降级已有受支持版本。
  • 统一 Capability Layer： Skill、Extension、Package、MCP 与 Preset 共用一个领域模型；Pi Coding Agent 仍是唯一 Agent Runtime。
  • Featured Skill 生命周期： Odai 作为普通可信目录 Skill 接入，支持校验安装、更新、启用/停用、刷新、备份与卸载，没有专属 Runtime 分支。
  • Package 对账与修复： 全局/项目 npm、git、local Package 会被识别为健康、缺失、孤立、权限异常、损坏或未知，并提供验证后的修复、重新注册、重新安装、孤立清理和彻底卸载。
  • 所有 Skill 都可安全卸载： 用户编写或单独安装的 Skill 会先备份再删除；Package 提供的 Skill 会卸载所属 Package，不会只删子目录制造残缺扩展包。
  • 29 个内置 Matt Pocock Skills： 支持离线全局/项目安装、精确 Ownership、内容哈希、冲突与本地修改检测、单个/批量卸载、更新和重装。
  • Runtime 驱动的看板娘： 6 套主题通过只读适配器观察 Pi Runtime，支持思考、执行、编程、工具、等待、检查、完成、失败、警告、问候、庆祝和休眠等 13 个状态。
  • 头顶状态气泡： 工作区看板娘会在头顶显示实时任务文字，完成和失败状态可明确识别；工具活动可细分为代码、命令、Git、浏览器、搜索、文件、Skill、Package 与 Extension。
  • 看板娘访问锁： 设置默认收起并锁定；完成内置知识题前，Main 进程会拒绝 Renderer 绕过限制启用看板娘。

可靠性与安全

  • Renderer 只能提交经过类型与 Schema 校验的标识和结构化目标；可信来源、命令、安装路径与删除路径全部由 Main 派生。
  • 环境和 Package 命令均使用固定可执行文件与参数数组；npm 权限修复不会执行 sudo。
  • Node 下载必须通过官方 SHA-256；替换范围被限制在专用受管目录，并具备 staging 与 rollback。
  • Skill 更新、替换和删除均先备份，并同时执行词法路径与真实路径校验；外部符号链接不会被跟随。
  • Package 启动预检会阻止缺失、损坏或不可访问的已注册 Package 进入 Agent Session，避免静默恢复掩盖问题。
  • Provider 启用状态严格最多一个；过期刷新结果和快速并发切换不会再显示“全部开启”。

升级说明

  • 已健康安装的 Node.js 22+ 与 Pi 会被直接复用，不会降级。
  • 看板娘仍默认关闭；无效、未解锁设置会回退为“无看板娘”，完成提示音仍默认关闭。
  • 如果已注册 Pi Package 状态异常，请先进入“技能 → 扩展包”修复或彻底卸载，再启动 Agent Session。
  • Pi-Harness 仍是轻量代码编辑器与桌面控制面，不新增第二套 Agent Runtime、集成终端、调试器、LSP 或 IDE 扩展宿主。

环境要求

  • 安装包用户：可直接在 Pi-Harness 内安装或修复 Pi Coding Agent
  • 从源码构建：Node.js ≥ 22，pnpm 9.12.1

한국어

v1.1.0은 Node.js/Pi 원클릭 환경 설치, 통합 Capability/Package 수명 주기, 29개의 내장 Matt Pocock Skills, Pi Runtime 이벤트 기반 13상태 마스코트를 추가합니다.

주요 변경 사항

  • 공식 체크섬 검증, 사용자 디렉터리 설치, npm/PATH 복구 및 최종 pi --version 검증
  • 신뢰 카탈로그 Skill, Package 상태 조정/복구, 백업 우선 제거 및 모든 독립 Skill 제거 지원
  • 전역/프로젝트 범위로 설치 가능한 29개의 오프라인 내장 Skills
  • 완료, 실패, 대기, 경고 및 도구별 작업을 표시하는 마스코트 머리 위 상태 말풍선

Русский

v1.1.0 добавляет установку среды Node.js/Pi в один клик, единый жизненный цикл Capability/Package, 29 встроенных Skills Matt Pocock и 13 состояний маскота на основе событий Pi Runtime.

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

  • Проверка официальных контрольных сумм, установка в пользовательский каталог, восстановление npm/PATH и итоговая проверка pi --version
  • Доверенные Skills, сверка/восстановление Packages и удаление всех самостоятельных Skills с резервной копией
  • 29 офлайн Skills для глобальной или проектной установки
  • Облачко состояния над маскотом для завершения, ошибки, ожидания, предупреждения и текущего инструмента

Français

La v1.1.0 ajoute l’installation en un clic de l’environnement Node.js/Pi, un cycle de vie Capability/Package unifié, 29 Skills Matt Pocock intégrés et 13 états de mascotte pilotés par les événements Pi Runtime.

Points clés

  • Vérification des sommes officielles, installation utilisateur, réparation npm/PATH et validation finale de pi --version
  • Skills de confiance, rapprochement/réparation des Packages et suppression sauvegardée de tous les Skills autonomes
  • 29 Skills hors ligne installables globalement ou par projet
  • Bulle d’état au-dessus de la mascotte pour la réussite, l’échec, l’attente, les avertissements et les outils

Deutsch

v1.1.0 ergänzt eine Ein-Klick-Installation für Node.js/Pi, einen einheitlichen Capability-/Package-Lebenszyklus, 29 integrierte Matt-Pocock-Skills und 13 durch Pi-Runtime-Ereignisse gesteuerte Maskottchen-Zustände.

Highlights

  • Offizielle Prüfsummen, Installation im Benutzerverzeichnis, npm-/PATH-Reparatur und abschließende pi --version-Prüfung
  • Vertrauenswürdige Skills, Package-Abgleich/Reparatur und gesicherte Entfernung aller eigenständigen Skills
  • 29 offline global oder projektbezogen installierbare Skills
  • Statusblase über dem Maskottchen für Abschluss, Fehler, Warten, Warnungen und aktive Werkzeuge

Full changelog: v1.0.9...v1.1.0

Assets 5
Loading