su-code

A fork of t3-code — a multiplexer web UI for coding agents — stripped of Codex, Claude, Cursor, and OpenCode integrations, with a Pi Coding Agent engine integrated in-process.

Quick Start

bun install
bun run dev          # server (13773) + web (5733)

Open http://localhost:5733.

Architecture

Browser (React + Vite) ──WebSocket── Server (Effect-TS) ──In-Process── Pi SDK
                                      │
                                      ├── Orchestration Engine (event sourcing, SQLite)
                                      ├── Git integration
                                      ├── Terminal PTY
                                      ├── Auth / Pairing
                                      └── Pi session manager (Map<ThreadId, AgentSession>)

What's Kept

• Frontend (apps/web/) — React + Vite chat UI, sidebar, diff panel, terminal, settings
• Server core (apps/server/) — WebSocket, orchestration, git, terminal, auth, persistence
• Contracts (packages/contracts/) — Shared Effect Schemas for all wire types
• Shared utilities (packages/shared/, packages/client-runtime/)

What's Stripped

• Codex, Claude, Cursor, OpenCode provider drivers
• ACP protocol SDK, Codex app-server SDK
• Desktop Electron shell, marketing site

What's Next

• PiDriver — wraps Pi SDK's createAgentSession() as a t3code provider driver
• PiEventMapper — maps Pi SDK events to canonical ProviderRuntimeEvent stream
• Pi text generation (commit messages, branch names, PR titles)
• Pi settings UI
• Steering / follow-up via Pi SDK message queue

Documentation

See docs/ for full documentation:

• Architecture
• Development
• Orchestration Engine
• Provider Driver System
• Frontend
• Contracts
• Project Status

See docs/cli-agent-integration-pattern.md for how the original t3-code provider integrations worked.