会话工作区
按项目工作目录（CWD）自动组织历史会话树，使多项目并发开发时的上下文浏览、切换和恢复更加直观、扁平。
Codex Desktop Workspace
极简纯净的
AI 编程智能体工作台
Pi Agent Desktop 将 Pi 编程智能体带入一个专为开发者设计的 Codex 极简窗口。整合会话管理、双轨分支、代码编辑器与工具链，让你的大模型代码生成井然有序。
session workspace
codegraph indexing
branch navigation
electron standalone
AppShell.tsx
styles.css
script.js
1
import { useState } from "react";
2
import { AppShell } from "@/components/AppShell";
3
4
export default function Home() {
5
return (
6
<AppShell>
7
<WorkspaceGrid />
8
</AppShell>
9
);
10
}
Pi Assistant
查询 AppShell 的实现，并优化布局。
pi-agent
使用 codegraph 查询 WorkspaceGrid 相关的符号依赖...
call
codegraph_explore query: "AppShell"
Features & Specs
为高效代码智能体工作流而生
剔除繁杂，专注于最关键的上下文、分支探索、以及原生 Electron 的无缝接入。
双轨分支探索
支持物理 Fork（创建独立 session.jsonl 文件）与会话内分支切换（通过 navigate_tree 回退到历史节点继续对话），完美契合 AI 多样化试错。
CodeGraph 深度集成
对于索引过的项目，内置 CodeGraph MCP 工具可以直接进行高效的跨文件符号关系、定义及引用搜索，无需在大量无关文件之间反复切换。
标签页式工作台
内置轻量级代码浏览器与 Tab 切换机制，使智能体的输出、工具链的调用与实际的源文件保持在同一屏中，上下文零断层。
Technical Stack
轻量级双向融合架构
Pi Agent Desktop 使用 Next.js / React 搭建交互层，Electron 提供桌面化外壳，通过 SSE (Server-Sent Events) 与 Pi 智能体核心保持高频实时通信。
React & Next.js UI
复用现代化 Web UI，基于 TailwindCSS 和 Vanilla CSS 进行主题与响应式精细调整。通过自定义 SSE client 监听智能体实时响应。
Electron 原生托盘
独立窗口运行，支持快速唤醒、最小化到系统托盘，并集成自动更新检查模块。生产环境下通过 Node.js 进程级托管 Next.js 服务端。
Setup & Deployment
三步快速运行工作台
你可以通过克隆源码或下载最新版发行程序，在本地快速接入你的 Pi coding agent。
1. 安装依赖软件包
npm install
copy
2. 启动 Web 开发服务器 (默认端口: 30141)
npm run dev
copy
3. 以 Electron 桌面模式启动独立客户端
npm run dev:electron
copy