Start hereSystem map
Start heresource checked

The complete system map

A spatial map that separates client surfaces, transport, transactional state, hot delivery, side effects, provider routing, and external execution.

What this chapter resolves
  • Locate every major package at its runtime boundary.
  • See which edges carry commands, events, provider-native protocol, or filesystem effects.

For a selected environment, authoritative repository and provider execution occurs behind that environment’s server boundary. A client can supervise several such environments, while Electron and mobile also own device-local storage, navigation, notifications, preview, update, and operating-system integrations.

Figure 0.1 · Architecture map · durability and ownership bandslinked nodes open the chapters already authored
Delivery
Local CLI + webHosted webElectroniOS / AndroidMarketing publication
Reachability
Loopback / bearerTailscale endpointT3 Connect tunnelDesktop SSH forward
Shared client
Connection registrySupervisor + one-attempt RPCState factories + caches
Trust boundary
HTTP auth + snapshotsWebSocket commands + liveScopes + typed contracts
Coordination
Serialized command queueIn-memory command model
Decision
Invariant planningClock + UUID EffectsNo persistence / provider I/O
Transaction
Event logSQL projectionsAccepted receipt
Post-commit
Hot event PubSubBest-effort reactorsLive subscription
Read side
Snapshot queryBounded replayKeyset pages + watermarks
Work services
Git + checkpointsFiles + assetsPTY terminalsPreview + MCP + VCS
Provider route
ProviderServiceInstance registryProviderAdapter
Harnesses
CodexClaudeCursorGrokOpenCode
Text equivalent

Clients use authenticated HTTP for snapshots and query pages and WebSocket RPC for commands and live subscriptions. A serialized in-memory queue invokes a persistence- and provider-I/O-free decision layer that still reads the clock and creates UUIDs. That decision happens before events, SQL projections, and accepted receipts commit together. A hot PubSub then feeds best-effort reactors and live subscribers. Provider work routes through ProviderService, an instance registry, and one provider adapter before reaching the five native harnesses.

Figure 0.1. The queue, decision step, PubSub, and reactors are deliberately outside the transactional band. SQLite query projections and committed live events reach clients through different read paths.

Two return paths, one write path

Figure 0.2 · Intent goes down; snapshots and events come backdashed arrows cross a non-durable delivery seam
Intent and state flow across T3 Code layersDiagram loading

Zoom with the controls, +/, or Ctrl/ + trackpad scroll. Enable Pan to drag, use two-finger scrolling, or use the arrow keys. 0 fits the diagram; Esc leaves Pan or expanded view.

Intent and state flow across T3 Code layers
Text equivalent

A client sends a typed command by WebSocket. The in-memory queue calls the decision layer before the SQL boundary, then atomically commits events, SQL projections, and an accepted receipt. After commit, a hot event bus independently feeds live subscribers and provider reactors. A reactor routes through ProviderService and an adapter to a harness. Canonical harness events return through runtime ingestion and re-enter the command queue. Separately, authenticated HTTP reads authoritative SQLite snapshots for initial and reconnect synchronization.

Figure 0.2. The adapter stops provider-native shapes from leaking upward. Snapshot queries read SQL projections; live subscriptions consume the post-commit event stream. A crash after commit but before a reactor side effect is a real recovery gap.

The downward path is imperative: “start this turn,” “accept this approval,” “revert this checkpoint.” The upward path is descriptive: assistant deltas, activities, plans, usage, session state, and changed-file summaries. The adapter is where each harness’s vocabulary becomes the canonical provider-runtime vocabulary.

Three UI families, four execution clients, five delivery shapes

apps/web serves three roles: the browser UI copied into the npm CLI, the hosted product UI, and the Electron renderer. Electron and React Native add very different native systems around shared connection/state semantics. The marketing Astro site is the fifth delivery shape, but it is a publication surface—not an execution client.

Cross-surface capability comparison for local web, hosted web, Electron, iOS, and Android
CapabilityLocal webHosted webElectroniOSAndroid
Environment serverCLI-ownedremotemanaged local/WSLremoteremote
Terminal rendererGhostty WASMGhostty WASMGhostty WASMnative Ghosttynative Ghostty VT
Offline new-task intentdurable outboxdurable outbox
Environment provisioningprimary/pairpair/relayprimary, WSL, SSHpair/relaypair/relay
Distinctive native edgelocal browsercloud identitypreview, updates, OS IPCAPNs, Live Activities, shareshare, widgets

Source trail

T3
Source-locked editionRead against fa219001d · 23 Aug 2026
Book search

Find a concept, module, or source path

Type two or more characters.