# PI-Desktop | Lan | Knowledge Base | Instagit

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

GitHub Stars: 2.5k

Repository: https://github.com/vastsa/PI-Desktop

---

## Articles

### [System Requirements for Running PI-Desktop on Linux: Complete 2024 Guide](/vastsa/PI-Desktop/pi-desktop-linux-system-requirements)

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.

- Tags: getting-started
- Published: 2026-09-13

### [How PI-Desktop Ensures Secure Opening of External URLs](/vastsa/PI-Desktop/pi-desktop-secure-external-url-handling)

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

- Tags: security
- Published: 2026-09-12

### [How to Update PI-Desktop: The Official Release Workflow Explained](/vastsa/PI-Desktop/how-to-update-pi-desktop)

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.

- Tags: how-to-guide
- Published: 2026-09-12

### [How PI-Desktop Handles Native Notifications Using Its Focus-Aware Policy](/vastsa/PI-Desktop/pi-desktop-native-notifications-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.

- Tags: how-to-guide
- Published: 2026-09-12

### [PI-Desktop Plugin Manifest File Structure: Complete Schema Guide](/vastsa/PI-Desktop/pi-desktop-plugin-manifest-file-structure)

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

- Tags: api-reference
- Published: 2026-09-12

### [Where to Find the End-to-End (E2E) Test Plan for PI-Desktop](/vastsa/PI-Desktop/pi-desktop-e2e-test-plan-location)

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.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Validate Code Changes in PI-Desktop: The Complete Workflow](/vastsa/PI-Desktop/steps-to-validate-code-changes-pi-desktop)

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.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Import Existing Sessions from Other Agents into PI-Desktop](/vastsa/PI-Desktop/how-to-import-sessions-other-agents-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.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Add Custom Model Providers in PI-Desktop Settings: Complete Configuration Guide](/vastsa/PI-Desktop/how-to-add-custom-model-providers-pi-desktop)

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.

- Tags: how-to-guide
- Published: 2026-09-12

### [Understanding mcp-control.json in PI-Desktop: The MCP Control Plane Manifest](/vastsa/PI-Desktop/purpose-of-mcp-control-json-file)

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.

- Tags: deep-dive
- Published: 2026-09-12

### [How PI-Desktop Plugin Permissions and Isolation Work: A Complete Technical Guide](/vastsa/PI-Desktop/pi-desktop-plugin-permissions-isolation)

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

- Tags: deep-dive
- Published: 2026-09-12

### [How PI-Desktop Plugins Are Packaged and Distributed: Understanding the .piplug Format](/vastsa/PI-Desktop/pi-desktop-plugin-packaging-distribution)

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.

- Tags: internals
- Published: 2026-09-12

### [PI-Desktop Plugin Contribution Points: A Complete Guide to Extending the Desktop](/vastsa/PI-Desktop/pi-desktop-plugin-contribution-points)

Explore PI-Desktop plugin contribution points including Panels, Views, Commands, and more. Learn how to extend the desktop environment via manifest.json and permissions.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Build and Contribute to PI-Desktop Plugins: A Complete Developer Guide](/vastsa/PI-Desktop/how-to-build-and-contribute-to-pi-desktop-plugins)

Learn to build and contribute to PI-Desktop plugins. Follow this guide to create, validate, and pack your plugins for distribution with the Plugin DevKit CLI.

- Tags: how-to-guide
- Published: 2026-09-12

### [Role of the Electron Main Process in PI-Desktop: Architecture and Responsibilities](/vastsa/PI-Desktop/electron-main-process-role-pi-desktop)

Discover the Electron main process role in PI-Desktop. It bootstraps the client, manages OS resources, and secures IPC for React and backend plugins.

- Tags: architecture
- Published: 2026-09-12

### [How the PI-Desktop Rust Host Core Manages State and Permissions](/vastsa/PI-Desktop/rust-host-core-pi-desktop-state-permissions)

Discover how the PI-Desktop Rust host core manages state and permissions using a centralized AppState struct for secure data and resource handling. Learn about strict isolation.

- Tags: internals
- Published: 2026-09-12

### [PI-Desktop Renderer Process Limitations: Security Constraints and Node Integration](/vastsa/PI-Desktop/pi-desktop-renderer-process-limitations)

Discover PI-Desktop renderer process limitations. Learn how Node integration is disabled and system interactions are secured via IPC for enhanced safety. Explore security constraints and integration.

- Tags: internals
- Published: 2026-09-12

### [How Data Persistence Works in PI-Desktop: SQLite and JSONL Architecture](/vastsa/PI-Desktop/pi-desktop-data-persistence-management)

Understand PI-Desktop's data persistence. Explore its SQLite and JSONL architecture for secure storage of conversations, settings, and credentials. Learn how it protects sensitive data.

- Tags: architecture
- Published: 2026-09-12

### [PI-Desktop Approval Modes: Tool vs Contract Permissions Explained](/vastsa/PI-Desktop/pi-desktop-approval-modes-explained)

Understand PI-Desktop approval modes: tool permissions like allow-once and contract permissions such as read, write, or admin. Learn how they work.

- Tags: deep-dive
- Published: 2026-09-12

### [How PI-Desktop Handles IPC Communication Between Renderer and Host Processes](/vastsa/PI-Desktop/how-does-pi-desktop-handle-ipc-communication)

Learn how PI-Desktop manages IPC communication. Discover its typed, versioned system using contextBridge, allow-lists, and IpcRegistrar for seamless renderer and host process interaction.

- Tags: how-to-guide
- Published: 2026-09-12

### [Core Technologies Used in PI-Desktop's Architecture: A Complete Technical Breakdown](/vastsa/PI-Desktop/what-are-the-core-technologies-used-in-pi-desktop-architecture)

Explore the core technologies powering PI-Desktop: React, Electron, and Rust. Discover how this local-first workspace integrates frontend, backend, and AI agent for a seamless experience.

- Tags: architecture
- Published: 2026-09-12

### [How to Set Up PI-Desktop for Local Development: Complete Setup Guide](/vastsa/PI-Desktop/how-to-set-up-pi-desktop-for-local-development)

Learn how to set up PI-Desktop for local development with this complete guide. Install Node.js, pnpm, and Rust, clone the repo, and run simple commands to launch the application.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Integrate PI Desktop with Other Systems: A Complete Plugin Development Guide](/vastsa/PI-Desktop/how-to-integrate-pi-desktop-with-other-systems)

Learn to integrate PI Desktop with external systems using its plugin architecture and host API. Develop secure bidirectional communication for commands, agent tools, and more.

- Tags: how-to-guide
- Published: 2026-09-12

### [Troubleshooting Common PI Desktop Errors: A Complete Guide to Result Types and Error Codes](/vastsa/PI-Desktop/troubleshooting-common-pi-desktop-errors)

Troubleshoot common PI Desktop errors with our guide. Learn about Result types and error codes for network, tool, permission, and plugin failures to implement consistent retry logic and user messaging.

- Tags: how-to-guide
- Published: 2026-09-12

### [What is the PI Desktop License? Understanding LGPL-3.0 Terms and Compliance](/vastsa/PI-Desktop/what-is-the-license-for-pi-desktop)

Understand the PI Desktop license, LGPL-3.0. Discover how this permissive license enables free use, modification, and distribution for open-source and proprietary projects.

- Tags: getting-started
- Published: 2026-09-12

### [How to Contribute to PI Desktop: A Complete Developer's Guide](/vastsa/PI-Desktop/how-to-contribute-to-pi-desktop-project)

Contribute to PI Desktop by forking the vastsa/PI-Desktop repo. Follow our guide to set up your environment, create branches, and submit pull requests for a smooth developer experience.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Report a Bug in PI Desktop: Complete Guide to Built-in GitHub Integration](/vastsa/PI-Desktop/how-to-report-a-bug-in-pi-desktop)

Easily report bugs in PI Desktop using the built-in GitHub integration. Follow our complete guide to submit issues quickly and efficiently, improving the software for everyone.

- Tags: how-to-guide
- Published: 2026-09-12

### [Where to Find the PI Desktop Documentation: A Complete Guide to the VitePress Site](/vastsa/PI-Desktop/where-to-find-pi-desktop-documentation)

Find the PI Desktop documentation easily within the vastsa/PI-Desktop repository. This guide directs you to the VitePress site and its main entry point for all your documentation needs.

- Tags: documentation-guide
- Published: 2026-09-12

### [Is PI Desktop Open Source? License, Source Code, and Architecture Explained](/vastsa/PI-Desktop/is-pi-desktop-open-source)

Discover if PI Desktop is open source. Explore its LGPL-3.0 license, view the full Rust, Electron, and React source code on GitHub, and understand its architecture.

- Tags: faq
- Published: 2026-09-12

### [How to Manage Users and Permissions in PI Desktop: A Complete Guide to RACP Roles](/vastsa/PI-Desktop/how-to-manage-users-and-permissions-in-pi-desktop)

Master PI Desktop user and permission management with RACP roles. Learn how viewer, controller, approver, and owner roles authorize operations through the Principal object for secure access.

- Tags: how-to-guide
- Published: 2026-09-12

### [PI Desktop Security Features: Plugin Isolation and Policy Enforcement Explained](/vastsa/PI-Desktop/what-are-the-security-features-of-pi-desktop)

Explore PI Desktop security features like plugin isolation and policy enforcement. Learn how Electron sandboxing and manifest policies protect your host system from untrusted code.

- Tags: deep-dive
- Published: 2026-09-12

### [How to Set Up PI Desktop Predictive Maintenance: Skills, MCP, and Subagents Guide](/vastsa/PI-Desktop/how-to-use-pi-desktop-for-predictive-maintenance)

Learn how to set up PI Desktop predictive maintenance using Skills MCP and Subagents. Monitor your codebase detect anomalies and prevent failures with local data.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Set Up Alerts in PI Desktop: Toast and Notification Center Implementation](/vastsa/PI-Desktop/how-to-set-up-alerts-in-pi-desktop)

Learn how to set up alerts in PI Desktop using toast and Notification Center. Implement real-time notifications from JavaScript/TypeScript plugins and core code.

- Tags: how-to-guide
- Published: 2026-09-12

### [What File Formats Does PI Desktop Export To? Complete MIME‑Type Mapping Guide](/vastsa/PI-Desktop/what-file-formats-does-pi-desktop-export-to)

Discover PI Desktop export file formats including CSV, HTML, JSON, PDF, ZIP, and images. Learn about MIME type mapping for seamless data integration.

- Tags: api-reference
- Published: 2026-09-12

### [How to Export Data from PI Desktop: Complete Guide to Workspace Backup](/vastsa/PI-Desktop/how-to-export-data-from-pi-desktop)

Export data from PI Desktop effortlessly. This guide details workspace backup using JSON export via Electron and Node.js APIs for secure data management.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Use PI Desktop for Real‑Time Data Monitoring](/vastsa/PI-Desktop/can-pi-desktop-be-used-for-real-time-data-monitoring)

Discover how PI Desktop enables real-time data monitoring with its stream-enabled agent runtime. Get instant UI updates without polling and streamline your data analysis.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Perform Data Analysis with PI Desktop: The Complete Plugin Development Guide](/vastsa/PI-Desktop/how-to-perform-data-analysis-with-pi-desktop)

Learn how to perform data analysis with PI Desktop. Import data into the Rust core, process with JavaScript plugins, and visualize results in this complete development guide.

- Tags: how-to-guide
- Published: 2026-09-12

### [Charting Options in PI Desktop: What Visualization Features Are Available?](/vastsa/PI-Desktop/what-charting-options-are-available-in-pi-desktop)

Explore PI Desktop charting options. Discover how to integrate external libraries like Chart.js via the Agent Runtime for custom visualizations. Learn more today.

- Tags: feature-overview
- Published: 2026-09-12

### [How to Import Data into PI Desktop: 3 Methods Explained](/vastsa/PI-Desktop/how-to-import-data-into-pi-desktop)

Learn how to import data into PI Desktop using 3 methods: clipboard paste, drag-and-drop, and the pasteFiles API. Streamline your data workflows today.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Create a New PI Desktop Project: A Step-by-Step Guide](/vastsa/PI-Desktop/how-to-create-a-new-pi-desktop-project)

Learn to create a new PI Desktop project by cloning the repository, installing dependencies, running the scaffolding script, and launching your workspace. Get started today!

- Tags: how-to-guide
- Published: 2026-09-12

### [What Data Sources Does PI Desktop Support? A Complete Technical Guide](/vastsa/PI-Desktop/what-data-sources-does-pi-desktop-support)

Explore supported data sources for PI Desktop. Learn about model and plugin registry sources like bundled, discovered, builtin, and installed in this technical guide.

- Tags: how-to-guide
- Published: 2026-09-12

### [How to Configure PI Desktop Connection Settings: A Complete Guide](/vastsa/PI-Desktop/how-to-configure-pi-desktop-connection-settings)

Learn how to configure PI Desktop connection settings with this complete guide. Easily manage MCP servers, AI providers, and network proxies for secure and immediate activation.

- Tags: how-to-guide
- Published: 2026-09-12

### [PI Desktop System Requirements: OS, Toolchain, and Build Prerequisites](/vastsa/PI-Desktop/what-are-the-system-requirements-for-pi-desktop)

Discover PI Desktop system requirements. Learn OS, Node.js, pnpm, and Rust prerequisites for building from source. Ensure compatibility for your development.

- Tags: getting-started
- Published: 2026-09-12

### [How to Install PI Desktop on Windows: NSIS Installer and Portable Setup Guide](/vastsa/PI-Desktop/how-to-install-pi-desktop-on-windows)

Install PI Desktop on Windows with our easy guide. Choose the NSIS installer for seamless integration or the portable version for quick setup without admin rights.

- Tags: how-to-guide
- Published: 2026-09-12

### [What Does Local-First Desktop Workspace Mean for PI-Desktop?](/vastsa/PI-Desktop/what-does-local-first-desktop-workspace-mean-for-pi-desktop)

Discover what a local-first desktop workspace means for PI-Desktop. Learn how its core functions run directly on your machine for enhanced privacy and offline access.

- Tags: architecture
- Published: 2026-09-11

### [How PI-Desktop Handles Secrets Securely: Electron-Rust Architecture Explained](/vastsa/PI-Desktop/how-does-pi-desktop-handle-secrets-securely)

Discover how PI-Desktop securely handles secrets using its Electron-Rust architecture. Learn how credentials are routed to the Rust core and stored in the OS encrypted vault, never touching JavaScript.

- Tags: architecture
- Published: 2026-09-11

### [How Built-In Tools Are Executed in PI-Desktop: A Complete Technical Guide](/vastsa/PI-Desktop/how-are-built-in-tools-executed-within-pi-desktop)

Learn how built-in tools execute in PI-Desktop with this technical guide. Discover the static declaration system and command dispatch process via Electron.

- Tags: how-to-guide
- Published: 2026-09-11

### [What Is the Command Palette in PI-Desktop? Architecture, Usage, and Plugin Integration](/vastsa/PI-Desktop/what-is-the-role-of-the-command-palette-in-pi-desktop)

Discover the PI-Desktop command palette a unified keyboard interface for built-in and plugin actions. Learn its architecture usage and integration to boost productivity.

- Tags: architecture
- Published: 2026-09-11

### [How PI-Desktop File Scope Configuration Works: A Complete Guide to Plugin Permissions](/vastsa/PI-Desktop/how-does-pi-desktop-file-scope-configuration-work-for-permissions)

Master PI-Desktop file scope configuration and plugin permissions. Learn how activation and manifest scopes control extension file access for enhanced security and functionality.

- Tags: how-to-guide
- Published: 2026-09-11

### [PI-Desktop Plugin Manifest Structure: Complete JSON Schema and Validation Guide](/vastsa/PI-Desktop/how-is-the-plugin-manifest-structure-defined-for-pi-desktop)

Understand the PI-Desktop plugin manifest structure with our complete JSON schema and validation guide. Learn how to define your plugin's metadata, UI, and security policies.

- Tags: api-reference
- Published: 2026-09-11

### [What Types of Contributions Can PI-Desktop Plugins Make?](/vastsa/PI-Desktop/what-types-of-contributions-can-plugins-make-to-pi-desktop)

Discover the ten contribution types PI-Desktop plugins offer, from commands and panels to skills and themes. Extend PI-Desktop functionality with custom plugins.

- Tags: how-to-guide
- Published: 2026-09-11

### [How to Develop and Install Plugins for PI-Desktop: Complete Developer Guide](/vastsa/PI-Desktop/how-can-i-develop-and-install-plugins-for-pi-desktop)

Learn to develop and install plugins for PI-Desktop with this guide. Leverage the plugin SDK and DevKit CLI to extend PI-Desktop functionality with AI skills, tools, and UI panels.

- Tags: how-to-guide
- Published: 2026-09-11

### [PI-Desktop Request Paths for Conversations and Tool Calls: RACP API Reference](/vastsa/PI-Desktop/what-is-the-request-path-for-a-conversation-and-tool-call-in-pi-desktop)

Learn the PI-Desktop RACP API request paths for conversations and tool calls. Find the correct endpoints for /v1/sessions/{sessionId} and /v1/sessions/{sessionId}/turns.

- Tags: api-reference
- Published: 2026-09-11

### [How PI-Desktop Manages Agent Workflows: From Interactive Chat to Sub-Agent Execution](/vastsa/PI-Desktop/how-are-agent-workflows-managed-in-pi-desktop)

Discover how PI-Desktop manages agent workflows using its agent plan and goal lifecycle. Transition from chat to autonomous execution with sub-agent delegation.

- Tags: internals
- Published: 2026-09-11

### [What Is TypeBox Used for in PI-Desktop? A Deep Dive into Schema-First Architecture](/vastsa/PI-Desktop/what-is-typebox-used-for-in-pi-desktop)

Discover how TypeBox in PI-Desktop acts as the single source for TypeScript schema definitions, powering RACP and ensuring compile-time type safety with runtime validation.

- Tags: deep-dive
- Published: 2026-09-11

### [How PI-Desktop Achieves UI and Privileged Runtime Separation](/vastsa/PI-Desktop/how-does-pi-desktop-handle-ui-and-privileged-runtime-separation)

Learn how PI Desktop separates UI and privileged runtime. Discover its three-layer architecture isolating file access, secrets, and native tools in Rust for enhanced security.

- Tags: architecture
- Published: 2026-09-11

### [Node pi Agent Sidecar: Purpose and Architecture in PI-Desktop](/vastsa/PI-Desktop/what-is-the-purpose-of-the-node-pi-agent-sidecar)

Discover the Node pi Agent Sidecar's role in PI-Desktop. Learn how this Node.js process handles AI runtime, model execution, and session state for seamless application performance.

- Tags: architecture
- Published: 2026-09-11

### [How the Rust Host Core Handles Privileged Operations in PI-Desktop](/vastsa/PI-Desktop/how-does-the-rust-host-core-handle-privileged-operations-in-pi-desktop)

Discover how the Rust Host Core in PI-Desktop manages privileged operations. Learn about its PermissionManager for risk classification, allowlists, and user prompts for secure execution.

- Tags: internals
- Published: 2026-09-11

### [What Is the Role of Electron Main in PI-Desktop?](/vastsa/PI-Desktop/what-is-the-role-of-electron-main-in-pi-desktop)

Discover the crucial role of Electron Main in PI-Desktop. Learn how it manages the application lifecycle, OS windows, IPC, plugins, and backend services for robust performance.

- Tags: internals
- Published: 2026-09-11

### [PI-Desktop Architecture: How the Hybrid Rust-Electron Stack Is Structured](/vastsa/PI-Desktop/how-is-the-pi-desktop-architecture-structured)

Explore the PI-Desktop architecture structured with a Rust core for security, Electron for plugin sandboxing, and React for the UI. Learn about this hybrid stack.

- Tags: architecture
- Published: 2026-09-11

### [Core Technologies Used in PI-Desktop: React, Rust, and Electron Architecture](/vastsa/PI-Desktop/what-are-the-core-technologies-used-in-pi-desktop)

Explore the core technologies of PI-Desktop: React, Rust, and Electron. Discover how this AI coding workspace leverages a powerful tech stack for security and local-first operation.

- Tags: architecture
- Published: 2026-09-11