当 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/wangmiaozer...
- 下载安装：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.