我给 Pi Coding Agent 做了一个桌面控制台： Pi-Harness

当 AI Coding Agent 真正进入项目开发后，一个聊天窗口很快就不够用了。

你需要选择模型，配置 Provider ，查看上下文占用，知道 Agent 调用了哪些工具；你还要在多个 Session 之间切换，浏览文件、检查 Git Diff 、管理 Skills ，必要时处理 Compaction 、Steering 和 Follow-up 。

这些能力并不缺，但它们往往散落在命令行、配置文件和不同工具里。

所以我做了 Pi-Harness：一个面向 Pi Coding Agent 的开源桌面 Harness 与控制中心。

一句话概括它：

Pi 负责运行 Agent ，Pi-Harness 负责让你看见并控制它是如何运行的。

它不是另一个套壳聊天客户端

Pi Coding Agent 本身已经拥有完整的 Agent Harness：Agent Loop 、工具、上下文、Compaction 、Queue 和 Session 等核心能力，都由 Pi 负责。

Pi-Harness 不替换 Pi ，也不重新实现一套 Agent Runtime 。它做的是另外一件事：把 Pi 周围原本分散的操作，组织成一个可见、可控、可管理的原生桌面工作区。

你可以直接使用 Native Pi ，并继续兼容 Pi CLI 的 Session ；也可以在同一个应用里完成模型配置、能力管理、项目浏览和 Git 操作。

这不是把终端藏进窗口里，而是给 Pi 增加一个真正围绕开发工作流设计的桌面控制平面。

从“和 Agent 对话”，到“观察 Agent 工作”

在 Pi-Harness 的工作区里，你可以新建或继续 Pi Session ，实时查看流式回复、Thinking 、Tool Call 、Context 使用量和 Session Stats 。

模型、Thinking Level 和工具预设可以直接切换；需要时，可以控制 Compaction ，发送 Steering 或 Follow-up ，也可以 Fork 和导航 Session 历史。

这带来的变化很直接：Agent 不再只是一个不断输出文字的黑盒。

你能知道它当前使用什么模型、上下文还剩多少、调用过哪些工具、Session 处于什么状态，也能在任务进行中及时调整方向。

项目、文件和 Git ，就在 Agent 旁边

写代码时，真正消耗注意力的往往不是某一次问答，而是在项目、终端、编辑器和 Git 工具之间反复切换。

Pi-Harness 把这些高频操作收进了同一个工作区：

• 浏览项目文件，并对可读文本进行轻量编辑；
• 显式保存文件，提示未保存状态，并处理外部修改冲突；
• 查看 Git 状态和 Diff ，配合 Worktree 管理并行工作；
• 打开多根 .code-workspace，在多个项目目录之间搜索和切换；
• 让 Session 、文件和版本变更保持在同一份项目上下文中。

Pi-Harness 对编辑器的定位也很明确：它提供的是紧贴 Agent 工作流的轻量文本编辑能力，而不是再造一个 IDE 。它不会用 LSP 、调试器或复杂插件系统把桌面端变成另一个庞然大物。

需要深度编码时，你仍然可以使用熟悉的 IDE ；需要观察和控制 Agent 时，Pi-Harness 保持足够集中、足够轻量。

Provider 和模型配置，不必再手改 JSON

多模型开发的麻烦，通常不在于“模型不够多”，而在于 Provider 、协议、Base URL 、鉴权方式和模型参数很容易互相混淆。

Pi-Harness 提供了完整的 Provider 与模型管理界面。你可以搜索预设，也可以接入兼容服务或自建网关；可以选择协议、填写 Key 、测试连接，并设置当前使用的模型。

对于需要同时使用 OpenAI 兼容接口、Anthropic 、Google 、NVIDIA NIM 、Ollama 或其他自定义服务的开发者，这比频繁打开配置文件、检查字段和排查格式问题更直接。

Skills 和能力包，有了统一入口

v1.3.0 新增了统一的能力中心。

内置与本地 Skills 、已安装能力包、精选增强能力，以及 Pi 的实时能力包市场，都可以在这里集中查看和管理。市场支持搜索、筛选、排序、分页、详情、安装和更新。

Pi-Harness 保持 Native Pi 为内置默认能力。Superpowers 、Odai 等方法论属于可选增强项，只有在用户主动确认后才会安装或启用。

也就是说，你既可以保持一套干净、原生的 Pi 工作流，也可以按项目需要逐步组合自己的能力栈。

工具可以专业，也可以有一点个性

开发工具不一定只能是千篇一律的深色面板。

Pi-Harness 提供明暗主题、界面密度和多种外观风格。v1.3.0 还完整重制了古风桌面主题，从全窗口场景、人物、装饰边框，到按钮、标题栏、菜单、下拉框和 Harness 界面，都采用了统一的视觉语言。

如果你更偏爱克制的生产力界面，可以继续使用默认主题；如果想让每天打开的开发工具更有辨识度，也可以一键换一种氛围。

目前界面已支持 English 、简体中文、繁體中文、日本語、한국어、Русский、Français 和 Deutsch 。

谁适合使用 Pi-Harness ？

如果你符合下面任意一种情况，Pi-Harness 可能会很顺手：

• 已经在使用 Pi Coding Agent ，希望获得更直观的桌面工作区；
• 经常切换不同 Provider 、模型和 Thinking Level ；
• 希望清楚看到 Agent 的上下文、工具调用和 Session 状态；
• 需要统一管理 Skills 、Packages 和可选开发方法论；
• 想把 Agent 、项目文件与 Git 变更放在同一个界面中；
• 喜欢 Pi 的轻量与可组合，但希望减少手改配置和命令行切换。

三步开始使用

Pi-Harness 已提供 macOS Apple Silicon 、macOS Intel 、Windows x64 和 Linux x64 安装包。

使用流程很简单：

1. 安装并启动 Pi-Harness ，检查 Node.js 、npm 、PATH 与 Pi 环境；
2. 配置 Provider ，选择模型；
3. 打开项目，新建或继续一个 Pi Session 。

安装包用户不需要 Clone 仓库，也不需要安装 pnpm 。在支持的环境中，Pi-Harness 可以检测、安装和修复 Node.js 、npm 、PATH 与 Pi Coding Agent 。

当前版本：v1.3.0

• 项目主页：github.com/wangmiaozero/pi-harness
• 下载安装：Pi-Harness v1.3.0 Releases
• 开源协议：GNU AGPL v3.0 only

macOS 社区构建可能没有签名。如果首次启动被系统拦截，可以前往“系统设置 → 隐私与安全性 → 仍要打开”，具体说明可查看 Release Notes 。

写在最后

我做 Pi-Harness ，不是为了给 Pi 换一个聊天窗口。

我更想解决的是：当 Agent 开始承担真正的项目任务时，我们如何看清它的状态，如何控制它的行为，又如何让模型、上下文、工具、Session 、Skills 、文件和 Git 回到同一个工作现场。

Pi-Harness 仍在继续完善。下一阶段，我会继续打磨 Harness Console ，让 Runtime 、Context 、Tools 、Compaction 和 Session 之间的关系更直观。

如果这个方向也解决了你的痛点，欢迎下载体验，也欢迎在 GitHub 给项目点一个 Star。你的反馈，会帮助 Pi-Harness 变成一个更成熟、更好用的 Pi 桌面工作区。

Everything around Pi, in one place.