Pi Agent Chat

A full-stack AI coding assistant with desktop (Electrobun) and web support, built with React, TypeScript, and Tailwind CSS.

Features

• AI Chat Interface - Real-time streaming conversations with AI coding agents
• Desktop + Web - Runs as a native desktop app via Electrobun or in the browser
• Message Queue - Steer and follow-up on agent messages mid-stream
• Activity Timeline - Visual timeline of agent activities (tool calls, state changes)
• Markdown Rendering - Full GFM support with syntax highlighting, Mermaid diagrams, and diffs
• i18n - Multi-language support via i18next
• Virtual Scrolling - High-performance message list with TanStack Virtual

Tech Stack

| Layer | Technology | | --------------- | ------------------------------------ | | Desktop Runtime | Electrobun (Bun) | | Frontend | React 18 + TypeScript | | Styling | Tailwind CSS | | Build | Vite 6 | | State | Zustand | | RPC | @dyyz1993/rpc-core (WebSocket / IPC) | | Testing | Vitest + Playwright |

Getting Started

Prerequisites

• Bun >= 1.0
• Node.js >= 18 (for Playwright E2E tests)

Install

bun install

Development

# Desktop app with HMR (recommended)
bun run dev:hmr

# Web-only mode
bun run dev:web

# Desktop without HMR
bun run dev

Build

bun run build          # Vite build
bun run build:canary   # Build + Electrobun canary package

Lint & Format

bun run lint           # ESLint
bun run format         # Prettier (write)
bun run lint:full      # ESLint + Prettier check

Test

bun run test           # Vitest unit tests
bun run test:watch     # Vitest in watch mode

Project Structure

├── src/
│   ├── bun/               # Main process (Electrobun/Bun server)
│   ├── mainview/          # React frontend
│   │   ├── components/    # UI components (chat, activity, message blocks)
│   │   ├── stores/        # Zustand state stores
│   │   ├── lib/           # Utilities (api-client, i18n, clipboard)
│   │   └── types/         # TypeScript type definitions
│   └── shared/            # Shared types and RPC schema
├── scripts/               # Build and utility scripts
├── e2e/                   # Playwright E2E tests
├── test/                  # Vitest unit tests
├── docs/                  # Design documents
├── electrobun.config.ts   # Electrobun configuration
├── vite.config.ts         # Vite configuration
└── vitest.config.ts       # Vitest configuration

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Commit your changes (git commit follows Conventional Commits)
4. Push to the branch (git push origin feat/my-feature)
5. Open a Pull Request

Please run bun run lint:full before submitting.

License

This project is licensed under the GNU Affero General Public License v3.0 (AGPL-3.0).

• ✅ 个人学习、研究、非商业使用：免费
• ✅ 修改源码：允许，但修改后的版本必须同样以 AGPL-3.0 开源
• ✅ 网络使用（SaaS）：允许，但必须向用户提供完整源码
• ❌ 商业闭源使用：禁止，需单独联系获取商业授权

详见 LICENSE 文件。