VibedByKaKi/t3-code-android-nightly
1
0
Fork 0
mirror of https://github.com/VibedByKaKi/t3-code-android-nightly.git synced 2026-10-09 11:51:15 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
t3-code-android-nightly/apps/mobile/modules/t3-terminal
History
Julius Marminge cc41482df0
feat(auth): allow passive terminal observation (#9791) 
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
2026-10-06 20:30:13 -07:00
..
android feat(auth): allow passive terminal observation (#9791) 2026-10-06 20:30:13 -07:00
ios feat(auth): allow passive terminal observation (#9791) 2026-10-06 20:30:13 -07:00
scripts chore: bump vendored GhosttyKit and update terminal integration (#9155) 2026-09-02 00:57:01 -05:00
Vendor/libghostty chore: bump vendored GhosttyKit and update terminal integration (#9155) 2026-09-02 00:57:01 -05:00
expo-module.config.json T3 Code Mobile [WIP] (#2013) 2026-05-29 17:00:54 -07:00
package.json T3 Code Mobile [WIP] (#2013) 2026-05-29 17:00:54 -07:00
README.md chore: bump vendored GhosttyKit and update terminal integration (#9155) 2026-09-02 00:57:01 -05:00
T3TerminalNative.podspec T3 Code Mobile [WIP] (#2013) 2026-05-29 17:00:54 -07:00
THIRD_PARTY_NOTICES.md chore: bump vendored GhosttyKit and update terminal integration (#9155) 2026-09-02 00:57:01 -05:00

README.md

T3 Mobile Terminal Native Module

This local Expo module owns the native terminal surface for the mobile app.

The JavaScript contract is intentionally small:

  • input from the native surface is emitted as { data: string }
  • resize from the native surface is emitted as { cols: number, rows: number }
  • remote PTY output is delivered by the existing WsRpcClient.terminal RPC stream

The iOS implementation uses the vendored GhosttyKit.xcframework built from VVTerm's Ghostty custom-I/O and live-padding branch. T3TerminalView owns a libghostty surface and uses that callback I/O model:

  1. initialize libghostty once for the process
  2. create one Ghostty app and surface per native view
  3. feed remote output into the surface with ghostty_surface_feed_data
  4. send user input back to JS with the write callback
  5. emit Ghostty's measured terminal size through onResize

Android implements the same view contract with upstream libghostty-vt for terminal state, parsing, reflow, and scrollback. An Android Canvas view renders compact snapshots produced by the JNI bridge, so the React Native screen and RPC code stay platform-neutral.

Vendored Ghostty revision and license details are in THIRD_PARTY_NOTICES.md.

Rebuilding GhosttyKit

The checked-in GhosttyKit.xcframework is built from Yash Singh's Ghostty fork at revision cf8edc23f3a6a87a96e41a90013e89e987d34980. Set GHOSTTY_SOURCE_DIR to a clone of https://github.com/Yash-Singh1/ghostty checked out at that revision (the t3code/custom-io-ordered-feed branch when vendored, based on VVTerm's vvterm/custom-io-padding branch).

apps/mobile/modules/t3-terminal/scripts/build-libghostty-ios16.sh

The script builds Ghostty with Zig 0.16.0, strips the iOS archives, and replaces only the ios-arm64 and ios-arm64-simulator slices. Xcode's Metal toolchain must be installed; if metal fails, run xcodebuild -downloadComponent MetalToolchain.

Rebuilding libghostty-vt for Android

The checked-in Android shared libraries and headers are pinned to the revision recorded in native/libghostty-vt/VERSION at the repository root. Set ANDROID_NDK_HOME and run:

apps/mobile/modules/t3-terminal/scripts/build-libghostty-android.sh

The script downloads Zig 0.15.2 when needed, checks out the pinned upstream Ghostty revision, and rebuilds all four Android ABIs with 16 KB page-size support.