feat(mobile): Add terminal powered by libghostty

[juliusmarminge]

Summary

• Adds a new Expo-based apps/mobile client with app variants for development, preview, and production.
• Implements mobile connection, thread, review, git, and terminal flows, including remote terminal attachment and session state handling.
• Adds native terminal support via a local Expo module backed by the vendored Ghostty framework on iOS and a platform-neutral JS bridge.
• Improves review rendering and highlighter support, including diff previews, word diffs, and Shiki-backed highlighting.
• Extends shared/server runtime pieces to support the mobile client, remote runtime registration, and related orchestration changes.

Testing

• Not run locally in this summary.
• Added/updated unit tests for pairing, terminal behavior, review model/highlighter logic, thread activity, repository grouping, and native terminal module helpers.
• Repo-level checks expected before merge: bun fmt, bun lint, and bun typecheck.
• Mobile-specific runtime validation to perform: launch the app, create/connect a remote environment, open a thread, and verify terminal and review screens render and respond to input.

---

Note

Medium Risk
Medium risk due to adding a large vendored native iOS framework and changing iOS deployment target/build settings, which can impact build size, licensing compliance, and runtime compatibility.

Overview
Introduces a new local Expo module (apps/mobile/modules/t3-terminal) to provide a native terminal surface with a small JS bridge contract (input + resize events) and iOS implementation backed by a vendored GhosttyKit.xcframework, alongside Android parity via the shared view name/event payloads.

Updates the Expo app config to apply expo-build-properties and set the iOS deployment target to 16.1, and adds third-party notice documentation for the vendored Ghostty fork/revision.

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

Note

Add in-app terminal powered by libghostty to the mobile app

• Introduces a full terminal feature for the mobile app, including native iOS (T3TerminalView backed by libghostty/GhosttyKit) and Android (T3TerminalView backed by a ScrollView+EditText) terminal surface views registered as the T3TerminalSurface Expo module.
• Adds ThreadTerminalRouteScreen as a dedicated full-screen terminal route (threads/[environmentId]/[threadId]/terminal) with session bootstrapping, input handling, font-size controls, and multi-terminal switching.
• Introduces createTerminalSessionManager in client-runtime to manage per-session output buffers (capped by UTF-8 byte size), hydrate from snapshots, track known sessions, and invalidate by environment.
• Adds a TerminalClosedEvent contract type and propagates closed events from the server terminal manager through to the web and mobile UIs.
• Adds project-script and terminal-session menus to ThreadGitControls, allowing users to run scripts or open terminals directly from the git toolbar.
• Refactors cwd/worktree resolution across git hooks and sheets into a shared useSelectedThreadWorktree hook.
• Risk: Vendors two prebuilt static libraries (libghostty-fat.a for device and simulator) and raises iOS minimum deployment target to 16.1.

^{Macroscope summarized aa9773b.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: d259fe25-302f-4eea-80bf-eab6afa546d5

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch t3code/mobile-remote-connect-rebase

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[macroscopeapp]

Approvability

Verdict: Needs human review

1 blocking correctness issue found. Diff is too large for automated approval analysis. A human reviewer should evaluate this PR.

^{You can customize Macroscope's approvability policy. Learn more.}

[juliusmarminge]

bugbot run

[cursor]

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

^{Reviewed by Cursor Bugbot for commit 95ffb0f. Configure here.}