Code - AI Code Assistant

⚡

30x Faster Communication

In-process tRPC communication eliminates network overhead. Direct function calls instead of HTTP requests mean ~0.1ms latency vs ~3ms for traditional HTTP.

🔄

Real-time Streaming

Built on tRPC v11 subscriptions with full type safety. Watch AI responses, tool executions, and system events stream in real-time with Observable-based primitives.

🎯

Pure UI Client Architecture

Zero business logic in the client. Server handles all decisions and state management. Event-driven communication ensures perfect decoupling with 33 comprehensive tests.

🌐

Multi-Client Synchronization

TUI and Web interfaces synchronized via event streams. Changes in one client instantly appear in all others through server-side event propagation.

🛠️

10+ Built-in AI Tools

Production-ready tools for file operations, search, shell commands, and user input. Smart diffing, background jobs, and streaming output built-in.

🤖

Multi-Provider AI Support

One interface for OpenRouter (200+ models), Anthropic Claude, OpenAI GPT-4, Google Gemini, and custom providers. Switch between models seamlessly.

🖥️

Terminal UI (TUI)

Ink-based interface with Vim-inspired navigation, smart autocomplete, real-time stats, and zero context switching for developers who live in the terminal.

🌐

Web UI

Modern React interface with mobile-responsive design, multi-tab sync via SSE, and real-time streaming. Built on the same headless SDK.

📦

Headless SDK

Build your own interface in minutes. VSCode extension, CLI tools, or custom UIs - all powered by the same zero-overhead core.

Operation	HTTP (localhost)	In-Process	Improvement
Simple query	~3ms	~0.1ms	30x faster
Streaming start	~5ms	~0.2ms	25x faster
Tool execution	~4ms	~0.15ms	27x faster

Operation

HTTP (localhost)

In-Process

Improvement

Simple query

~3ms

~0.1ms

30x faster

Streaming start

~5ms

~0.2ms

25x faster

Tool execution

~4ms

~0.15ms

27x faster

# Clone repository git clone https://github.com/SylphxAI/code.git cd code # Install dependencies bun install # Build core packages bun run build # Run Terminal UI bun dev:code # Run Web UI (in another terminal) bun dev:web

Architecture Highlights

Stack Overview

┌─────────────────────────────────────────────────────┐
│  🖥️  Terminal UI      🌐  Web UI                   │  React (Ink/Next.js)
├─────────────────────────────────────────────────────┤
│  @sylphx/code-client                                │  Pure UI Client
│  - Event-driven sync (33 tests ✅)                 │  - Zero business logic
│  - Zustand stores                                   │  - Optimistic updates
│  - tRPC in-process link                             │  - Multi-client ready
├─────────────────────────────────────────────────────┤
│  @sylphx/code-server                                │  Business Logic
│  - tRPC v11 server                                  │  - Daemon-ready
│  - Subscription streaming                           │  - Multi-session
│  - Server-side decisions                            │  - AppContext
├─────────────────────────────────────────────────────┤
│  @sylphx/code-core                                  │  Headless SDK
│  - AI providers                                     │  - 10+ tools
│  - Session persistence                              │  - Agent system
│  - Tool execution                                   │  - libSQL database
└─────────────────────────────────────────────────────┘

Key Design Principles

1. Pure UI Client + Daemon Server

Client handles UI state only (currentSessionId, isStreaming)

Server contains all business logic and can run independently

Optimistic updates for instant feedback

Event-driven communication with zero circular dependencies

2. Zero-Overhead Communication

Direct function calls via tRPC v11

No JSON serialization overhead

No network latency

Pure TypeScript end-to-end type safety

3. Multi-Client Synchronization

All clients synchronized via server events:

TUI Client 1 ←──┐
TUI Client 2 ←──┼── Server SSE Events
Web Client   ←──┘

Package	Lines of Code	Build Time
code-core	~8,000	75ms ⚡
code-server	~2,000	23ms ⚡
code (TUI)	~6,000	39ms ⚡

Package

Lines of Code

Build Time

code-core

~8,000

75ms ⚡

code-server

~2,000

23ms ⚡

code (TUI)

~6,000

39ms ⚡

Metric	Before	After	Improvement
Separation of Concerns	3/10	9/10	+200%
Decoupling	4/10	10/10	+150%
Testability	2/10	9/10	+350%
Multi-Client Ready	5/10	10/10	+100%

Metric

Before

After

Improvement

Separation of Concerns

3/10

9/10

+200%

Decoupling

4/10

10/10

+150%

Testability

2/10

9/10

+350%

Multi-Client Ready

5/10

10/10

+100%

CodeAI Code Assistant

30x Faster Communication

Real-time Streaming

Pure UI Client Architecture

Multi-Client Synchronization

10+ Built-in AI Tools

Multi-Provider AI Support

Terminal UI (TUI)

Web UI

Headless SDK

The Problem

The Solution

Performance Comparison

Quick Start

Architecture Highlights

Stack Overview

Key Design Principles

Build Performance

Architecture Quality (v0.1.0)

Support

License

CodeAI Code Assistant

30x Faster Communication

Real-time Streaming

Pure UI Client Architecture

Multi-Client Synchronization

10+ Built-in AI Tools

Multi-Provider AI Support

Terminal UI (TUI)

Web UI

Headless SDK

The Problem ​

The Solution ​

Performance Comparison ​

Quick Start ​

Architecture Highlights ​

Stack Overview ​

Key Design Principles ​

Build Performance ​

Architecture Quality (v0.1.0) ​

Support ​

License ​

The Problem

The Solution

Performance Comparison

Quick Start

Architecture Highlights

Stack Overview

Key Design Principles

Build Performance

Architecture Quality (v0.1.0)

Support

License