pi-harness v1.0.7
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
License change: Pi-Harness is now licensed under
AGPL-3.0-only. Please review the license before modifying, redistributing, or providing a modified version over a network.
English
v1.0.7 upgrades Pi-Harness from a desktop configuration manager into a complete native workspace for Pi Coding Agent. Manage Pi configuration and skills, open real projects, run persistent Pi sessions, inspect tool calls, edit files, and work with Git without leaving the desktop app.
Downloads
| Platform | File |
|---|---|
| macOS Apple Silicon | Pi-Harness-1.0.7-arm64.dmg |
| macOS Intel | Pi-Harness-1.0.7.dmg |
| Windows x64 | Pi-Harness Setup 1.0.7.exe |
| Linux x64 | Pi-Harness-1.0.7.AppImage |
macOS builds are unsigned. On first launch, use System Settings → Privacy & Security → Open Anyway, or run:
xattr -cr /Applications/Pi-Harness.appHighlights
- Native Agent Workspace: projects, persistent Pi Sessions, streaming chat, image attachments, thinking, tool calls, token/context statistics, abort, compaction, forks, and full history.
- Shared Pi sessions: Session JSONL under
~/.pi/agent/sessions/remains compatible with Pi CLI. Agent execution runs in Electron Main and streams through typed IPC; no iframe or HTTP server is required. - Project-first workflow: a project is required before starting a conversation. Project/session state, tabs, disabled actions, and empty states now stay consistent.
- Lightweight code editor: edit authorized text files with CodeMirror, syntax highlighting, find, undo/redo, unsaved buffers,
Cmd/Ctrl+S, explicit save, and SHA-256 external-change conflict protection. This is intentionally not a full IDE or LSP host. - Files and Git: hidden files and
node_modulesare visible; upload with size validation and overwrite confirmation; manual/automatic refresh; Git Diff and Worktree management. - Chat UX: Enter sends, Shift+Enter inserts a newline, sessions open at the bottom, and floating controls jump to the top or bottom. Streaming stays pinned only while the user remains near the bottom.
- AI Motion execution state: the full-window AI Motion effect appears only while an Agent is sending, running, streaming, or processing a prompt—not while the composer is merely focused.
- Skills and extensions: curated extension marketplace, package suites, individual install/uninstall, bulk install/uninstall, and improved missing-directory handling.
- Interaction polish: clearer pressed/selected states, disabled actions render as disabled, improved tabs and context menus, and refined Provider/Model forms.
- Reliability and security: trusted IPC validation, authorized-root path checks, canonical real-path compatibility, atomic writes, backup retention cleanup, and external modification protection.
- Branding and configuration: public environment variables now use
PI_HARNESS_*; legacyPI_SWITCH_*variables remain supported for compatibility. - License: relicensed from MIT to GNU Affero General Public License v3.0 only (
AGPL-3.0-only).
Requirements
- Pi Coding Agent, or install/update it from Pi-Harness
- From source: Node.js ≥ 22 and pnpm
9.12.1
简体中文
v1.0.7 将 Pi-Harness 从桌面配置管理器升级为 Pi Coding Agent 的完整原生工作台。除了管理 Pi 配置和技能,现在还可以直接打开真实项目、运行持久化 Pi Session、查看工具调用、编辑文件并使用 Git。
下载
| 平台 | 文件 |
|---|---|
| macOS Apple Silicon | Pi-Harness-1.0.7-arm64.dmg |
| macOS Intel | Pi-Harness-1.0.7.dmg |
| Windows x64 | Pi-Harness Setup 1.0.7.exe |
| Linux x64 | Pi-Harness-1.0.7.AppImage |
macOS 安装包未签名。首次打开时使用“系统设置 → 隐私与安全性 → 仍要打开”,或执行:
xattr -cr /Applications/Pi-Harness.app主要更新
- **原生 Agent 工作区:**支持项目、持久化 Pi Session、流式对话、图片附件、Thinking、Tool Call、Token/上下文统计、中止、压缩、Fork 和完整历史。
- **共享 Pi Session:**继续使用
~/.pi/agent/sessions/下的 Session JSONL,与 Pi CLI 兼容。Agent 在 Electron Main 中运行,通过类型化 IPC 流式传输,不依赖 iframe 或 HTTP 服务。 - **项目优先:**必须打开或选择项目后才能开始对话;项目、Session、标签页、禁用操作和空状态保持一致。
- **轻量代码编辑器:**基于 CodeMirror 编辑已授权项目内的文本文件,支持语法高亮、查找、撤销/重做、未保存缓冲、
Cmd/Ctrl+S、显式保存和 SHA-256 外部修改冲突保护;定位明确,不做完整 IDE 或 LSP。 - **文件与 Git:**显示隐藏文件和
node_modules;支持文件上传、大小校验、覆盖确认、手动/自动刷新、Git Diff 和 Worktree 管理。 - **对话体验:**Enter 发送,Shift+Enter 换行;进入 Session 默认滚动到底部;提供回到顶部和滚动到底部按钮。只有用户停留在底部附近时,流式消息才自动跟随。
- **AI Motion 执行状态:**只有 Agent 正在发送、运行、流式输出或处理 Prompt 时才显示全窗口 AI Motion;输入框单纯聚焦不会触发。
- **技能与扩展:**新增精选扩展市场、扩展套件、单个安装/卸载、一键安装/卸载,并优化技能目录不存在时的处理。
- **交互优化:**点击、选中和按下状态更清晰;不可操作项显示灰色禁用态;标签页、右键菜单、Provider/Model 表单交互得到完善。
- **可靠性与安全:**类型化可信 IPC、授权项目根目录校验、真实路径兼容、原子写入、备份保留清理和外部文件修改保护。
- **品牌与配置:**公开环境变量统一为
PI_HARNESS_*,旧PI_SWITCH_*继续兼容。 - **协议变更:**项目从 MIT 改为 GNU Affero General Public License v3.0 only(
AGPL-3.0-only)。
环境要求
- Pi Coding Agent,也可以在 Pi-Harness 内安装或更新
- 从源码构建:Node.js ≥ 22,pnpm
9.12.1
한국어
v1.0.7은 Pi-Harness를 데스크톱 구성 관리자에서 Pi Coding Agent를 위한 완전한 네이티브 작업 공간으로 확장합니다. Pi 구성과 스킬을 관리하고, 실제 프로젝트를 열고, 영구 Pi Session을 실행하며, 도구 호출 확인, 파일 편집 및 Git 작업을 앱 안에서 수행할 수 있습니다.
다운로드
| 플랫폼 | 파일 |
|---|---|
| macOS Apple Silicon | Pi-Harness-1.0.7-arm64.dmg |
| macOS Intel | Pi-Harness-1.0.7.dmg |
| Windows x64 | Pi-Harness Setup 1.0.7.exe |
| Linux x64 | Pi-Harness-1.0.7.AppImage |
macOS 빌드는 서명되지 않았습니다. 처음 실행할 때 시스템 설정 → 개인정보 보호 및 보안 → 확인 후 열기를 사용하거나 다음을 실행하세요.
xattr -cr /Applications/Pi-Harness.app주요 변경 사항
- 프로젝트, 영구 Pi Session, 스트리밍 채팅, Thinking, Tool Call, 컨텍스트 통계, 중단, 압축, Fork 및 전체 기록을 제공하는 네이티브 Agent 작업 공간
~/.pi/agent/sessions/의 Pi CLI 호환 Session JSONL과 Electron Main의 타입 지정 IPC 스트리밍- 프로젝트를 선택한 뒤에만 대화를 시작하는 일관된 프로젝트 우선 흐름
- CodeMirror 기반 경량 코드 편집기: 구문 강조, 찾기, 실행 취소/다시 실행, 저장되지 않은 버퍼,
Cmd/Ctrl+S, 외부 변경 충돌 보호 - 숨김 파일과
node_modules표시, 파일 업로드/새로 고침, Git Diff 및 Worktree - Enter 전송, Shift+Enter 줄바꿈, 기본 하단 위치, 위/아래 이동 버튼 및 안정적인 스트리밍 자동 스크롤
- Agent 실행 중에만 표시되는 전체 창 AI Motion 효과
- 확장 마켓, 패키지 모음, 개별/일괄 설치 및 제거
- 신뢰할 수 있는 IPC, 승인된 루트 경로 검사, 원자적 쓰기, 백업 정리 및 외부 수정 보호
- 공개 환경 변수는
PI_HARNESS_*를 사용하며 기존PI_SWITCH_*도 호환 - 라이선스를 MIT에서
AGPL-3.0-only로 변경
요구 사항
- Pi Coding Agent, 또는 Pi-Harness에서 설치/업데이트
- 소스 빌드: Node.js ≥ 22, pnpm
9.12.1
Русский
v1.0.7 превращает Pi-Harness из менеджера конфигурации в полноценную нативную рабочую среду для Pi Coding Agent. Теперь в приложении можно открывать реальные проекты, запускать постоянные Pi Session, просматривать вызовы инструментов, редактировать файлы и работать с Git.
Загрузки
| Платформа | Файл |
|---|---|
| macOS Apple Silicon | Pi-Harness-1.0.7-arm64.dmg |
| macOS Intel | Pi-Harness-1.0.7.dmg |
| Windows x64 | Pi-Harness Setup 1.0.7.exe |
| Linux x64 | Pi-Harness-1.0.7.AppImage |
Сборки macOS не подписаны. При первом запуске используйте «Системные настройки → Конфиденциальность и безопасность → Открыть всё равно» или выполните:
xattr -cr /Applications/Pi-Harness.appОсновные изменения
- Нативная рабочая область Agent: проекты, постоянные Pi Session, потоковый чат, Thinking, Tool Call, статистика контекста, остановка, сжатие, Fork и полная история
- Совместимые с Pi CLI Session JSONL в
~/.pi/agent/sessions/и потоковая передача через типизированный IPC из Electron Main - Начало диалога только после выбора проекта
- Лёгкий редактор CodeMirror с подсветкой синтаксиса, поиском, отменой/повтором, буферами несохранённых файлов,
Cmd/Ctrl+Sи защитой от внешних изменений - Скрытые файлы и
node_modules, загрузка и обновление файлов, Git Diff и Worktree - Enter для отправки, Shift+Enter для новой строки, открытие внизу истории и кнопки перехода вверх/вниз
- Полнооконный AI Motion только во время выполнения Agent
- Маркет расширений, наборы пакетов, индивидуальная и массовая установка/удаление
- Проверенный IPC, контроль разрешённых корней, атомарная запись, очистка резервных копий и защита от внешних изменений
- Новые публичные переменные
PI_HARNESS_*с совместимостью со старымиPI_SWITCH_* - Смена лицензии с MIT на
AGPL-3.0-only
Требования
- Pi Coding Agent или установка/обновление из Pi-Harness
- Сборка из исходников: Node.js ≥ 22, pnpm
9.12.1
Français
v1.0.7 fait évoluer Pi-Harness d’un gestionnaire de configuration vers un espace de travail natif complet pour Pi Coding Agent. L’application permet désormais d’ouvrir de vrais projets, d’exécuter des Pi Session persistantes, d’inspecter les appels d’outils, de modifier des fichiers et de travailler avec Git.
Téléchargements
| Plateforme | Fichier |
|---|---|
| macOS Apple Silicon | Pi-Harness-1.0.7-arm64.dmg |
| macOS Intel | Pi-Harness-1.0.7.dmg |
| Windows x64 | Pi-Harness Setup 1.0.7.exe |
| Linux x64 | Pi-Harness-1.0.7.AppImage |
Les builds macOS sont non signés. Au premier lancement, utilisez Réglages Système → Confidentialité et sécurité → Ouvrir quand même, ou exécutez :
xattr -cr /Applications/Pi-Harness.appPoints clés
- Espace Agent natif : projets, Pi Session persistantes, chat en streaming, Thinking, Tool Call, statistiques de contexte, arrêt, compactage, Fork et historique complet
- Session JSONL compatibles avec Pi CLI dans
~/.pi/agent/sessions/et streaming IPC typé depuis Electron Main - Projet obligatoire avant le démarrage d’une conversation
- Éditeur léger CodeMirror : coloration, recherche, annulation/rétablissement, buffers non enregistrés,
Cmd/Ctrl+Set protection contre les modifications externes - Fichiers cachés et
node_modules, téléversement/actualisation, Git Diff et Worktree - Enter pour envoyer, Shift+Enter pour une nouvelle ligne, ouverture en bas et boutons haut/bas
- AI Motion plein écran uniquement pendant l’exécution de l’Agent
- Marché d’extensions, suites de paquets, installation/désinstallation individuelle et groupée
- IPC vérifié, contrôle des racines autorisées, écritures atomiques, nettoyage des sauvegardes et protection contre les modifications externes
- Variables publiques
PI_HARNESS_*avec compatibilité des anciennesPI_SWITCH_* - Passage de la licence MIT à
AGPL-3.0-only
Prérequis
- Pi Coding Agent, ou installation/mise à jour depuis Pi-Harness
- Depuis les sources : Node.js ≥ 22, pnpm
9.12.1
Deutsch
v1.0.7 erweitert Pi-Harness vom Konfigurationsmanager zu einem vollständigen nativen Arbeitsbereich für Pi Coding Agent. Echte Projekte, persistente Pi Sessions, Tool-Aufrufe, Dateibearbeitung und Git stehen nun direkt in der Desktop-App zur Verfügung.
Downloads
| Plattform | Datei |
|---|---|
| macOS Apple Silicon | Pi-Harness-1.0.7-arm64.dmg |
| macOS Intel | Pi-Harness-1.0.7.dmg |
| Windows x64 | Pi-Harness Setup 1.0.7.exe |
| Linux x64 | Pi-Harness-1.0.7.AppImage |
macOS-Builds sind unsigniert. Verwenden Sie beim ersten Start Systemeinstellungen → Datenschutz & Sicherheit → Trotzdem öffnen oder führen Sie Folgendes aus:
xattr -cr /Applications/Pi-Harness.appHighlights
- Nativer Agent-Arbeitsbereich mit Projekten, persistenten Pi Sessions, Streaming-Chat, Thinking, Tool Call, Kontextstatistik, Abbruch, Komprimierung, Fork und vollständigem Verlauf
- Pi-CLI-kompatible Session JSONL unter
~/.pi/agent/sessions/und typisiertes IPC-Streaming aus Electron Main - Projekt erforderlich, bevor eine Unterhaltung gestartet werden kann
- Leichtgewichtiger CodeMirror-Editor mit Syntaxhervorhebung, Suche, Undo/Redo, ungespeicherten Puffern,
Cmd/Ctrl+Sund Schutz vor externen Änderungen - Versteckte Dateien und
node_modules, Upload/Aktualisierung, Git Diff und Worktree - Enter zum Senden, Shift+Enter für Zeilenumbruch, Start am unteren Rand und Schaltflächen nach oben/unten
- AI Motion im gesamten Fenster nur während der Agent-Ausführung
- Erweiterungsmarkt, Paketsammlungen sowie einzelne und gebündelte Installation/Deinstallation
- Vertrauenswürdiges IPC, Prüfung autorisierter Wurzeln, atomare Schreibvorgänge, Backup-Bereinigung und Schutz vor externen Änderungen
- Öffentliche Variablen
PI_HARNESS_*mit Kompatibilität zu altenPI_SWITCH_* - Lizenzwechsel von MIT zu
AGPL-3.0-only
Voraussetzungen
- Pi Coding Agent, oder Installation/Update aus Pi-Harness
- Aus dem Quellcode: Node.js ≥ 22, pnpm
9.12.1
Full changelog: v1.0.6...v1.0.7