Pi Desktop

把 Pi 接到桌面上，权限留在主进程。

Pi on the desktop. Privilege stays in main.

打开本地项目，与模型多轮对话，让代理读文件、跑工具、改代码。这是官方 Pi 的独立图形客户端，不是另一套 Agent 运行时，也不是 IDE 插件。

Open a local project, talk to a model, and let the agent read files, run tools, and edit code. An independent graphical client for official Pi — not another agent runtime, and not an IDE plugin.

下载最新版本 Download latest 查看源码 Source

macOS · Windows · 0.1.21 · MIT

它做什么

What it does

桌面端负责窗口、工作区和授权。会话循环、工具和模型协议交给已经发布的 Pi 包，不在本仓库里改上游。

The desktop owns the window, the workspace, and authorization. The session loop, tools, and model protocol come from the published Pi package. This repository does not patch upstream.

工作区

Workspace

  • 本地项目、历史与持久化状态
  • 文件浏览和预览
  • Git 变更、分支、Worktree
  • 内嵌终端
  • Local projects, history, persisted state
  • File browsing and preview
  • Git changes, branches, worktrees
  • Embedded terminal

会话

Sessions

  • 多轮对话、搜索、分支、Fork
  • 流式回复与思考过程
  • Markdown、KaTeX、Mermaid
  • 图片、文件引用、会话引用
  • Multi-turn chat, search, branches, fork
  • Streaming replies and reasoning
  • Markdown, KaTeX, Mermaid
  • Images, file refs, session refs

模型与扩展

Models and extensions

  • 供应商、API Key、OAuth
  • 模型发现与连接测试
  • Skills 搜索、安装、启停
  • Plugins 安装与配置
  • Providers, API keys, OAuth
  • Model discovery and connection tests
  • Skill search, install, toggle
  • Plugin install and configuration

桌面

Desktop

  • 中英文、明暗主题、自定义 CSS
  • 系统托盘、窗口状态恢复
  • 本仓库 GitHub Releases 更新
  • Chinese and English, light and dark, custom CSS
  • Tray and restored window state
  • Updates from this repo’s GitHub Releases

安全边界

Security boundary

渲染进程不能直接碰文件系统、子进程或网络。它只能走白名单 IPC。打开项目要先确认信任；每次内置工具调用要单独点头。已存密钥不会回到渲染进程。

The renderer cannot touch the filesystem, child processes, or the network directly. It talks through a allowlisted IPC bridge. Opening a project requires trust. Each built-in tool call needs its own approval. Stored credentials never return to the renderer.

审计只记元数据。更新源锁在本项目的 GitHub Releases。只打开你信任的目录——项目说明和扩展可以改变代理行为。

Audit logs keep metadata only. The update feed is this project’s GitHub Releases. Only open directories you trust — project instructions and extensions can change agent behavior.

下载与构建

Download and build

macOS
Releases 里的 .dmg 或 .zip
.dmg or .zip from Releases
Windows
NSIS .exe 或 .zip
NSIS .exe or .zip
开发
Develop
Node.js 22.19+ · npm install · npm run start
git clone https://github.com/Eileenes/pi-desktop.git
cd pi-desktop
npm install
npm run start