Pilo hsingjui

Pilo is a desktop client for Pi Coding Agent, not a separate agent implementation. It presents connections, projects, and Pi sessions in an IDE-style workspace while leaving conversation state and agent behavior to Pi. Highlights | Highlight | Why it matters | | ------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | Local, WSL, and SSH in one workspace | Projects stay in their original environments. Pilo runs pilo-server in the selected environment instead of copying remote projects to the desktop. | | Pi runs where the project lives | The server starts pi --mode rpc with the project directory as its working directory for Local, WSL, and SSH connections. | | Pi stays the source of truth | Sessions are read from Pi JSONL files; SQLite only stores rebuildable indexes, caches, and desktop state. | | Chat, tools, terminals, files, and diffs together | Pilo renders Pi thinking and tool calls alongside PTY terminals, file operations, preview ports, and Git status/diffs. | | Parallel agents | Multiple agent streams can run for a project and can be listed, messaged, or stopped independently. | | Native desktop updates | Release builds produce updater artifacts for Windows x64 and macOS arm64, and Pilo can check for updates from GitHub Releases. | Architecture Pilo consists of a desktop app and a pilo-server process that runs in the selected connection environment. Local runs directly, WSL uses wsl.exe, and SSH deploys a matching server binary to the remote host. Desktop/server communication uses protobuf Envelope frames over stdio through crates/pilo-protocol. ┌──────────────────────────────┐ │ Pilo Desktop │ │ React + Tauri 2 │ └──────────────┬───────────────┘ │ pilo-protocol / stdio ▼ ┌──────────────────────────────┐ │ pilo-server │ │ Local | WSL | SSH target │ └──────────────┬───────────────┘ │ pi --mode rpc ▼ ┌──────────────────────────────┐ │ Pi Coding Agent │ └──────────────────────────────┘