v0.4.1Discover what’s new Pi Agent Desktop icon

Pi Coding Agent
Desktop Workspace

Code, connect tools, and create images in one local-first workspace. Let Auto choose the model, and keep every tool call in view.

Local-first No internal server Cross-platform

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

New in v0.4.1

A smoother everyday workflow.

Pi Coding Agent 1.2.0 brings Windows PowerShell support, recoverable model settings, and more reliable tools, channels, and startup.

Windows PowerShell support

Use PowerShell 5.1 or 7 for Agent commands on Windows. Choose the default shell for new sessions while existing sessions keep their current shell.

Learn how to use it

Recover model configuration

See which fields need fixing when models.json is invalid. Sending pauses until you repair and reload the configuration, helping prevent requests to an unintended endpoint.

Learn how to use it

Consistent tool permissions

MCP aliases, tool search, and nested Codemode calls follow the same permission checks. Upgrading keeps existing session and channel grants within their original scope.

Learn how to use it

More reliable channel replies

Attachments stay with the correct turn. Cancelled or extension-handled messages no longer affect later Desktop turns or resend the previous assistant reply.

Learn how to use it

Core capabilities

More capable. More in your control.

Connect your tools, route each task to the right model, and follow the work from request to result.

Auto model routing

Choose a fast model and a capable model. Auto routes each new request by thinking level or task complexity, and shows which model actually answered.

Auto model routing
Auto model routingv0.4.0
Learn how to use it

MCP services

Connect local and remote tools with stdio or Streamable HTTP. Import configurations, sign in with OAuth, test connections, and preview resources in Settings.

MCP services
MCP servicesv0.4.0
Learn how to use it

Image generation and decisions

Use Codemode to generate images, classify content, answer yes/no questions, or score results. Generated images stay available when you reopen the conversation.

Learn how to use it

Tools and execution history

Follow direct and nested tool calls in a branch-aware execution tree. Inspect status, duration, inputs, and full results, even after reopening or compacting a session.

Learn how to use it

Features

A complete Agent workspace

From sessions, file previews, and a shared browser to Herdr Agent fleets, managed processes, models, extensions, and messaging, everyday work stays in one window.

A complete conversation experience

Adjust chat text, conversation width, and model-reply width; attach any file and queue Steer or Follow-up messages while pagination and deferred content keep long conversations responsive.

A browser shared with the Agent

Open real Chromium pages on the right with multiple tabs, profiles, and login state. After separate authorization, the Agent can read and operate the same page.

Conversational Herdr Agent fleets

Manage a local Agent fleet from the main conversation on macOS, Linux, and Windows x64, then observe, troubleshoot, or explicitly take keyboard control in the ANSI terminal.

A project-centered file experience

Manage Git branches and worktrees, recognize local Markdown paths, and use rich file actions while syntax highlighting, Mermaid, and KaTeX remain stable inside complex lists.

Models and extensions in one place

Pi Coding Agent 1.2.0 is included, with API key and subscription sign-in, model configuration, Auto routing, and advanced runtime controls.

Cross-platform developer tools

Discover and verify system tools, or install private Node.js, Python, Git, Bun, and common CLI runtimes on demand without changing the system PATH.

Messaging channels

Connect WeChat, Telegram, and Feishu / Lark. Create a new Feishu / Lark bot through the official QR flow or connect an existing custom app.

Observable managed processes

Let the Agent keep dev servers, watchers, and mock APIs running. Inspect state, readiness, and redacted logs, then stop, restart, or export logs from the right panel.

Secure by default

Renderer sandboxing, a strict CSP, and typed IPC contracts. The UI and control plane open no local ports; managed project services require explicit enablement.

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 · Official QR / Existing app

Architecture

Three isolated processes, sandboxed web content

Privileged desktop capabilities, the Agent runtime, and the UI are isolated. Agent Host connects the Browser, managed processes, and local Herdr Sessions.

Main process

Window · Tray · Updates
Browser Views and network policy

Agent Host

Pi Coding Agent in a utilityProcess
Browser · Processes · Herdr adapters

Renderer

React 19 UI
Controlled preload bridge

Browser View

Real Chromium pages
Sandbox · Profiles · Separate grants

Typed MessagePort IPC Revisioned Browser RPC No control-plane ports POSIX groups / Windows Job Objects Herdr protocol 20 Sessions and Pi settings 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 internal ports — The UI and control plane open no local ports; user-started project services may listen on loopback
Minimal exposure — Renderer sandbox + strict CSP + controlled preload bridge
Browser isolation — Remote pages receive no application preload, Node.js, or main Renderer bridge
Separate permissions — Coding, Browser, Herdr, and managed-process capabilities never implicitly enable one another
Runtimes off by default — Herdr and managed processes provide lifecycle control, not a security sandbox
Encrypted credentials — Channel tokens are encrypted with Electron safeStorage and never returned to the Renderer
Trusted updates — Update settings are fixed in production builds and do not accept external update URLs

Ready to keep Pi Agent on your desktop?

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

Download free