Pi Agent Desktop icon

Pi Coding Agent
Desktop Workspace

Sessions, files, models, and messaging channels in one local-first desktop app. No command line required—install and start working.

Local-first No local server Cross-platform

Current version v0.1.3·macOS, Windows, and Linux·View changelog

Features

A complete Agent workspace

From session management and file previews to model configuration and messaging channels, everything you need for everyday development lives in one window.

A complete conversation experience

Create, search, and group sessions by date. Follow streaming replies, tool calls, and context compaction, with queued messages and Steer / Follow-up interactions.

A project-centered file experience

Choose project folders natively, manage Git branches and worktrees, and preview Markdown, highlighted code, Mermaid, KaTeX, and Word documents.

Models and extensions in one place

Manage model providers and configuration, use browser OAuth, search and install Skills, and keep using Pi Agent's Plugin ecosystem.

Messaging channels

Connect WeChat, Telegram, and Feishu / Lark with private-chat pairing, group allowlists, and support for images, files, and voice messages.

Designed to keep running

Single-instance behavior, system tray, notifications, badges, remembered window state, system theme support, automatic Agent Host recovery, and diagnostics export.

Secure by default

Renderer sandboxing, a strict CSP, and typed IPC contracts. No local ports are opened, and sessions and configuration remain on your machine.

Channels

Keep the conversation going away from your desk

Connect WeChat, Telegram, or Feishu / Lark. Remote conversations use isolated sessions by default, or can share context with the current desktop session.

WeChat · QR sign-in Telegram · Bot Token Feishu / Lark · Custom app

Architecture

Three isolated processes, each with one job

Privileged desktop capabilities, the Agent runtime, and the UI are isolated. Production builds listen on no TCP ports and bundle no web server.

Main process

Window · Tray · Notifications · Updates
Agent Host supervision

Agent Host

Pi Coding Agent inside
an Electron utilityProcess

Renderer

React 19 UI
Controlled preload bridge

Typed MessagePort IPC No local ports Data stays in ~/.pi/agent/

Privacy & Security

Your data stays on your machine

Local-first is the default behavior, not a slogan.

Local data — Sessions and Pi configuration stay on your machine by default ~/.pi/agent/
No local ports — The UI does not open additional local network ports
Minimal exposure — Renderer sandbox + strict CSP + controlled preload bridge
Encrypted credentials — Channel tokens are encrypted with Electron safeStorage and never returned to the Renderer
Outbound connections only — No webhooks and no local listening ports
Trusted updates — Update settings are fixed in production builds and do not accept external update URLs

Ready to keep Pi Agent on your desktop?

The Pi Coding Agent runtime is included. Install the app, configure a model provider, and start working.

Download free