https://github.com/tyanxie/paimon
Paimon，让你能在浏览器里跟所有 Pi 实例对话。
https://github.com/tyanxie/paimon
coding-agent pi pi-coding-agent remote-control web
Last synced: 18 days ago
JSON representation
Paimon，让你能在浏览器里跟所有 Pi 实例对话。
- Host: GitHub
- URL: https://github.com/tyanxie/paimon
- Owner: tyanxie
- License: mit
- Created: 2026-05-18T10:46:14.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-08T12:39:38.000Z (22 days ago)
- Last Synced: 2026-06-12T07:34:40.663Z (18 days ago)
- Topics: coding-agent, pi, pi-coding-agent, remote-control, web
- Language: TypeScript
- Homepage:
- Size: 5.17 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
守望 · 交互 · 掌控
Paimon，让你能在浏览器里跟所有 [Pi](https://pi.dev/) 实例对话。
## 📸 截图
## ✨ 特性
- 💬 **实时对话流** — 流式输出、思考过程、工具调用全展示
- 🔄 **多实例切换** — 一个页面管理所有 pi 会话
- ➕ **页面创建实例** — 在页面上输入目录即可在 Hub 本机启动新 pi 实例并直接对话
- 📋 **Session 管理** — 浏览历史 session，一键新建或切换
- 🎨 **毛玻璃风格界面** — 清爽的 macOS 风格设计
- 📱 **响应式设计** — 桌面/移动端自适应，iOS Safe Area 适配
## 📋 前置要求
- [Pi](https://pi.dev/) >= 0.78.1
## 🚀 快速开始
```bash
# 克隆并安装依赖
git clone https://github.com/tyanxie/paimon.git && cd paimon
bun install
# 构建前端（Hub 启动依赖 dist/web/）
bun run build
# 安装 paimon CLI 到全局（软链接回当前目录）
bun link
# 安装 extension（让 pi 启动时自动加载）
pi install .
# 启动 Hub
paimon hub start
# 启动 pi
pi
# 打开浏览器
open http://localhost:8080
```
> ⚠️ `bun link` 通过软链接指向当前 clone 目录，**安装后请勿删除、移动或重命名该目录**，否则 `paimon` 命令会失效。
## 🛠️ paimon CLI
| 命令 | 说明 |
| --------------------------------------------------- | ------------------ |
| `paimon hub start [--port 8080] [--host 127.0.0.1]` | 启动 Hub daemon |
| `paimon hub stop` | 停止 Hub |
| `paimon hub status` | 查看运行状态 |
| `paimon hub logs [--follow]` | 查看日志 |
| `paimon attach [id]` | 接管实例到当前终端 |
> 🔒 `--host 0.0.0.0` 仅在可信网络使用（页面中指挥 Pi 可在 Hub 本机执行任意命令）。
## 🧹 卸载
```bash
# 在 clone 目录执行，解除全局链接
bun unlink
# 清理运行时状态
rm -rf ~/.paimon
```
## 💻 开发
```bash
# 开发模式：构建前端 + 启动 Hub + watch
bun run dev
# 直接运行 CLI 源码（无需 bun link）
bun src/cli/index.ts hub start
```
## 📄 License
MIT