Pi-Harness

项目简介 Pi-Harness 是 Pi Coding Agent 的开源可视化桌面控制台，提供图形化工作区来管理模型、上下文、会话、文件和 Git 操作，支持 macOS、Windows 和 Linux 当前版本 v1.4.0。Pi-Harness 并非网页包装器，不嵌入 pi-web、Next.js 服务器或 iframe，也不添加第二个 Agent 运行时——它直接嵌入 Native Pi，为 Pi Coding Agent 提供原生的可视化控制界面。

核心功能

模型管理：在一个界面中管理多个 AI 模型配置，无需记忆复杂的配置文件和命令行参数。

运行时状态可视化：实时展示 Pi Agent 的运行时状态——上下文使用量、工具调用队列、会话压缩进度——让用户对 Agent 工作过程有完全透明的了解。

文件浏览器：内置项目文件浏览器，无需切换到终端即可浏览和管理项目文件。

Git 面板：集成 Git 操作面板，支持查看文件变更历史、提交记录、分支管理，无需离开 Pi-Harness 界面。

技能管理：管理和配置 Pi Agent 的 Skills，直接在可视化界面中启用/停用技能。

会话管理：支持多标签页并行管理多个 Pi 会话，每个会话独立上下文，互不干扰。

MCP 工具浏览器：浏览和配置可用的 MCP 工具集。

跨平台支持：提供 macOS、Windows、Linux 三个平台的原生桌面客户端，采用各平台原生 UI 设计语言。

多语言界面：内置简体中文、繁体中文、英语、日语、韩语、俄语、法语、德语等多语言支持。

技术实现

Pi-Harness 嵌入的是 Pi Agent 的底层 CLI 和 SDK 行为——上下文状态通过 CLI 命令暴露、工具调用通过 SDK 行为自然触发——而非通过额外抽象层重新实现。这种"直接连接"设计保证了所有 Pi 原生能力都被保留，同时增加了可视化维度。

安装使用

从 GitHub releases 页面（https://github.com/wangmiaozero/pi-harness/releases）下载对应平台的最新安装包。

安装完成后启动 Pi-Harness，配置 Pi Agent 的路径和 API Key。

在"模型"面板中添加需要使用的 AI 模型（支持 OpenAI、Anthropic 等主流模型）。

开始新的会话后，即可在可视化界面中观察和管理 Pi Agent 的工作状态。

适用人群

使用 Pi Coding Agent 进行开发工作的程序员；希望对 AI 编程过程有可视化掌控力的开发者；需要在复杂项目中并行管理多个 AI 编程会话的团队。

开源协议：Apache-2.0

官网链接 https://github.com/wangmiaozero/pi-harness