How myliuyx/pi-workbench works
Pi Workbench presents Pi coding-agent capabilities through a shared browser UI, backed by a local HTTP/SSE core; Electron embeds that core for desktop use. The principal workflow is user prompt → UI transport → core session/agent → streamed events and persisted session → rendered conversation. Separate branches cover model/provider settings, approvals and trust, skills/resources, and filesystem browsing. The README documents these capabilities; links between components are included only where it or the supplied source excerpts/index support them.
Main entry points: session.ts Agent session · server.ts HTTP and SSE · App.tsx Workbench screens · live-transport.ts Live transport
Components 18
Workbench UI
- Workbench screens
packages/ui/src/App.tsx - Chat state
packages/ui/src/store/chat-store.ts - Live transport
packages/ui/src/services/live-transport.ts - Settings screens
packages/ui/src/screens/SettingsDialog.tsx
Core service
- HTTP and SSE
packages/core/src/server.ts - Core runtime
packages/core/src/main.ts - UI-core contract
packages/core/src/contract.ts
Agent capabilities
- Session persistence
packages/core/src/sessions.ts - Agent session
packages/core/src/session.ts - Models and providers
packages/core/src/providers.ts - Agent tools
packages/core/src/tools.ts - Trust and approvals
packages/core/src/trust.ts - Skills and resources
packages/core/src/skills.ts - Filesystem access
packages/core/src/fs-list.ts
Desktop shell
- Electron shell
packages/desktop/src/main.ts
Other components
- User
- Pi agent package
- Local machine
Connections 20
- User → Workbench screens: uses
README.md - Workbench screens → Chat state: presents chat
README.md - Chat state → Live transport: sends prompts
README.md - Live transport → HTTP and SSE: calls core
README.md - HTTP and SSE → Core runtime: serves runtime
packages/core/src/main.ts - Core runtime → HTTP and SSE: starts server
packages/core/src/main.ts - HTTP and SSE → Agent session: dispatches requests
packages/core/src/server.ts - Agent session → Pi agent package: creates session
packages/core/src/session.ts - Agent session → Session persistence: loads sessions
packages/core/src/session.ts - HTTP and SSE → Filesystem access: serves browsing
packages/core/src/server.ts - HTTP and SSE → UI-core contract: uses payloads
packages/core/src/server.ts - Agent session → Models and providers: uses providers
packages/core/src/session.ts - Agent session → Trust and approvals: checks trust
packages/core/src/session.ts - Agent session → Skills and resources: loads skills
packages/core/src/session.ts - Agent session → Agent tools: uses tools
packages/core/src/session.ts - Settings screens → Live transport: configures agent
README.md - HTTP and SSE → Local machine: reads files
packages/core/src/server.ts - Agent session → Local machine: persists sessions
README.md - Electron shell → Core runtime: spawns core
packages/desktop/src/main.ts - Electron shell → Workbench screens: loads interface
packages/desktop/src/main.ts