当 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 安装包。使用流程很简单： 安装并启动 Pi-Harness ，检查 Node.js 、npm 、PATH 与 Pi 环境； 配置 Provider ，选择模型； 打开项目，新建或继续一个 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.