PI-Desktop

Local-first AI coding agent desktop: Electron + Rust host core + pi Agent Harness + user-installable plugins

61 articles

System Requirements for Running PI-Desktop on Linux: Complete 2024 Guide

Discover the 2024 system requirements for PI-Desktop on Linux. Ensure your 64-bit x86 system meets glibc 2.35+ for smooth operation. Learn build requirements here.

getting-started

Sep 13, 2026

How PI-Desktop Ensures Secure Opening of External URLs

PI-Desktop securely opens external URLs by isolating link handling to the main process and validating all links against a strict allowlist.

security

Sep 12, 2026

How to Update PI-Desktop: The Official Release Workflow Explained

Update PI-Desktop by running the release script after validating version alignment. This triggers CI to build, sign, and publish official release artifacts for macOS, Linux, and Windows.

how-to-guide

Sep 12, 2026

How PI-Desktop Handles Native Notifications Using Its Focus-Aware Policy

Discover how PI-Desktop's focus-aware policy manages native notifications, suppressing alerts when active and controlling prompts based on session visibility for a seamless user experience.

how-to-guide

Sep 12, 2026

PI-Desktop Plugin Manifest File Structure: Complete Schema Guide

Explore the PI-Desktop plugin manifest file structure. Understand the complete schema for declaring plugin identity entry points UI configuration contributions and security policies.

api-reference

Sep 12, 2026

Where to Find the End-to-End (E2E) Test Plan for PI-Desktop

Locate the official PI-Desktop End-to-End E2E test plan in the vastsa/PI-Desktop repository. Discover testing strategy, tooling, and merge gates for comprehensive E2E testing.

how-to-guide

Sep 12, 2026

How to Validate Code Changes in PI-Desktop: The Complete Workflow

Learn how to validate code changes in PI-Desktop with this complete workflow. Execute type-checking linting unit tests sync specs run E2E tests and merge after gates pass.

how-to-guide

Sep 12, 2026

How to Import Existing Sessions from Other Agents into PI-Desktop

Learn how to import existing sessions from other agents into PI-Desktop using its two-step IPC workflow. Seamlessly convert external formats to native SQLite sessions.

how-to-guide

Sep 12, 2026

How to Add Custom Model Providers in PI-Desktop Settings: Complete Configuration Guide

Easily add custom model providers in PI-Desktop. Follow our complete guide to configure Base URL, API Key, and more via ProviderSetupDialog for your AI models.

how-to-guide

Sep 12, 2026

Understanding mcp-control.json in PI-Desktop: The MCP Control Plane Manifest

Discover the purpose of mcp-control.json in PI-Desktop. This manifest file publishes local MCP control plane connection info, enabling external agents to connect and authenticate.

deep-dive

Sep 12, 2026

How PI-Desktop Plugin Permissions and Isolation Work: A Complete Technical Guide

Explore how PI-Desktop plugin permissions and isolation work. Learn about sandboxed Node processes, manifest-driven permissions, and runtime validation via a Rust gateway.

deep-dive

Sep 12, 2026

How PI-Desktop Plugins Are Packaged and Distributed: Understanding the .piplug Format

Learn how PI-Desktop plugins are packaged and distributed using the .piplug format. Discover the store-only ZIP archive and its contents, vital for plugin development with the plugin-devkit toolchain.

internals

Sep 12, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:

curl -s "https://instagit.com/install.md"

Add to your MCP client configuration:

{
  "mcpServers": {
    "instagit": {
      "command": "npx",
      "args": ["-y", "instagit@latest"]
    }
  }
}

Ask your agent:

"Use Instagit MCP to understand how vastsa/PI-Desktop works."

Works with

Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →