🖥️ Pi GUI - Tauri Desktop App

A modern desktop GUI for the pi coding agent, built with Tauri (Rust + React).

✨ Features

• 🎨 Modern Dark UI - GitHub-inspired dark theme
• 💬 Session Management - Create and manage multiple chat sessions
• 🔧 Tool Call Visualization - See when pi uses bash, read, write, etc.
• 📂 File Integration - Open config directories and files
• ⚡ Keyboard Shortcuts - Enter to send, Shift+Enter for new lines
• 🚀 Native Performance - Rust backend with Web frontend

🛠️ Tech Stack

• Backend: Rust + Tauri
• Frontend: React + TypeScript
• Styling: CSS (GitHub dark theme)
• IPC: Tauri Commands + Events

📦 Installation

Prerequisites

1. Install Rust: https://rustup.rs/
2. Install Node.js: https://nodejs.org/ (v18+)
3. Install pi: npm install -g @mariozechner/pi-coding-agent

Build from Source

# Clone the repository
git clone https://github.com/HyperspaceNG/pi-gui.git
cd pi-gui

# Install dependencies
npm install

# Install Tauri CLI
cargo install tauri-cli

# Run in development mode
cargo tauri dev

# Build for production
cargo tauri build

Download Pre-built Binaries

Download the latest release from: https://github.com/HyperspaceNG/pi-gui/releases

🚀 Usage

1. Start the app - Launch Pi GUI from your applications menu
2. Click "Start Pi" - Initializes the pi RPC session
3. Create a new session - Click "New Session" to begin
4. Send messages - Type in the input box and press Enter
5. View responses - See pi's responses in real-time

🎮 Keyboard Shortcuts

Shortcut	Action
Enter	Send message
Shift + Enter	New line in input
Ctrl + L	Toggle sidebar

🏗️ Project Structure

pi-gui/
├── src/                    # React frontend
│   ├── App.tsx            # Main application component
│   ├── App.css            # Styles
│   └── main.tsx           # Entry point
├── src-tauri/             # Rust backend
│   ├── src/
│   │   └── main.rs        # Tauri commands
│   ├── Cargo.toml         # Rust dependencies
│   └── tauri.conf.json    # Tauri configuration
├── package.json           # Node dependencies
└── README.md

🔧 Development

Frontend Development

npm run dev          # Start Vite dev server

Backend Development

cargo tauri dev      # Start Tauri with hot reload

Building

# macOS
cargo tauri build --target aarch64-apple-darwin

# Windows
cargo tauri build --target x86_64-pc-windows-msvc

# Linux
cargo tauri build --target x86_64-unknown-linux-gnu

🤝 Contributing

1. Fork the repository
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit changes: git commit -am 'Add new feature'
4. Push to branch: git push origin feature/my-feature
5. Submit a pull request

📄 License

MIT © HyperspaceNG

🔗 Links

• Pi Documentation
• Tauri Documentation
• HyperspaceNG