T3 Code Mobile [WIP]

[juliusmarminge]

⚠️ WARNING :: VERY EARLY

Summary

• Add a new Expo-based mobile client with remote connection setup, thread browsing, new-thread flows, composer UI, and git action sheets.
• Move shared remote/runtime, git, thread-detail, and WebSocket state into packages/client-runtime and packages/shared so web and mobile can share the same behavior.
• Refactor desktop startup and readiness handling to rely on HTTP session readiness, simplify window bootstrap, and remove the old listening-detector path.
• Rework web connection, composer, sidebar, and git action flows to use the new shared runtime and state management.

Testing

• Not run (PR content only).

---

Note

High Risk
Large greenfield surface (native modules, vendored Ghostty, new RPC/review paths) plus cross-platform refactors to shared runtime and terminal ID defaults that can break persisted client state.

Overview
Adds a new Expo/React Native mobile client under apps/mobile (dev/preview/production variants, EAS, Uniwind theming, Expo Router) that talks to the same backend via @t3tools/client-runtime and @t3tools/shared.

Native surfaces: an iOS Ghostty-backed terminal module (t3-terminal, vendored GhosttyKit.xcframework) and an iOS native review diff renderer (t3-review-diff) with JSON-driven rows, token patches, and gestures; review highlighting defaults to JavaScript/Shiki via Metro workspace resolution.

Tooling & CI: new macOS job Mobile Native Static Analysis (swiftlint / ktlint / detekt via scripts/mobile-native-static-check.ts), bun lint:mobile documented in AGENTS.md, and formatter/linter ignore patterns for generated ios/android trees.

The broader PR (per description) also refactors web/desktop connection, terminal IDs, VCS/git state, and server review/terminal streaming to align with the shared runtime—treat persisted terminal IDs and RPC contracts as migration-sensitive.

^{Reviewed by Cursor Bugbot for commit 9a20e0b. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add mobile app with terminal, review diff, and Git action support

• Introduces the apps/mobile React Native/Expo app with routing, navigation, and theming; includes home, thread, review, terminal, and connection management screens
• Adds native iOS terminal surface backed by GhosttyKit and Android fallback; exposes T3TerminalSurface native module with input/resize events and buffer replay logic
• Adds native iOS T3ReviewDiffSurface with Shiki-based syntax highlighting, word-level diff ranges, and a review comment composer sheet with selection controller
• Extends packages/contracts with terminal.attach, subscribeTerminalMetadata, and review.getDiffPreview RPC endpoints; updates WsRpcClient and server WS layer accordingly
• Adds ReviewService on the server with workspace-bound cwd validation and GitVcsDriver.getReviewDiffPreview producing dirty and branch-range diff sources with SHA-256 hashes
• Migrates web terminal state from terminalStateStore to a new terminalUiStateStore (Zustand, persisted) with stable incremental terminal IDs (term-1, term-2, …) and server-side terminal open calls
• Ships new client-runtime modules: WsTransport, terminalSessionState, vcsStatusState, vcsRefState, vcsActionState, threadDetailState, checkpointDiffState, composerPathSearchState, archivedThreadsState, environmentConnection, and others
• Risk: terminalId is now required (no default) in TerminalSessionInput, TerminalWriteInput, TerminalResizeInput, and TerminalClearInput; callers not providing an explicit id will fail schema decoding

^{Macroscope summarized 9a20e0b.}