chore: bump vendored GhosttyKit and update terminal integration by Yash-Singh1 · Pull Request #9155 · pingdotgg/t3code

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

Yash-Singh1 · 2026-09-02T01:19:14Z

What Changed

Bumped the vendored GhosttyKit to revision cf8edc23f3a6a87a96e41a90013e89e987d34980.
Updated the iOS terminal build script, native headers, Swift integration, and third-party notices for the new Ghostty API and Zig 0.16.0.
Added mobile terminal panel support and related file, review, settings, connection, and state updates.
Simplified desktop update release-note normalization by removing omitted-count metadata and improving boilerplate filtering.
Added cursor-following preview label positioning logic with viewport clamping and flipping.
Updated supporting server, web, client-runtime, tests, and documentation to match the revised contracts and runtime behavior.

Why

The vendored GhosttyKit needs to be refreshed to incorporate the newer custom-I/O and live-padding implementation used by the mobile terminal. The integration changes keep the native terminal contract aligned with the updated library while enabling the associated mobile terminal experience.

The accompanying client and server changes update consumers of revised state and API contracts, remove obsolete release-note metadata, and improve behavior around previews, reviews, settings, and remote runtime state.

UI Changes

Added the mobile thread terminal panel.
Added cursor-following element-picker labels with edge clamping and vertical flipping.
Updated mobile settings, file/review surfaces, and related web update/sidebar behavior.

Before/after screenshots and interaction video are not included.

Checklist

This PR is small and focused
I explained what changed and why
I included before/after screenshots for any UI changes
I included a video for animation/interaction changes

Note

Medium Risk
Replaces the native iOS terminal binary and C ABI (clipboard/runtime callbacks); regression risk is mainly rendering, input, and resize on device/simulator rather than app-layer JS.

Overview
Refreshes the mobile iOS terminal’s vendored GhosttyKit.xcframework to revision cf8edc23, sourced from VVTerm’s custom-I/O and live-padding Ghostty lineage (t3code/custom-io-ordered-feed), and documents the new pin in README.md, THIRD_PARTY_NOTICES.md, and Vendor/libghostty/VERSION.

The iOS rebuild path now targets Zig 0.16.0, copies libghostty-internal.a from the upstream xcframework (still installed as libghostty-fat.a in vendor), syncs updated headers, and strips trailing whitespace on ghostty.h. The vendored framework drops bundled ghostty/vt/* headers that shipped inside the xcframework previously.

ghostty.h moves to a newer internal embedder ABI (richer clipboard types, new runtime actions, ghostty_config_key_is_binding on config instead of app). T3TerminalView is updated so the runtime read_clipboard_cb matches the new signature and reports GHOSTTY_CLIPBOARD_READ_UNSUPPORTED, since selection clipboard is not supported on mobile.

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

Note

Bump vendored `GhosttyKit` and update `t3-terminal` integration

Updates the vendored ghostty.h headers and static libraries to a new pinned revision from VVTerm's custom-I/O/live-padding branch
Expands the clipboard API with PRIMARY kind, explicit byte lengths, Kitty read/write and list request kinds, completion/confirmation payloads, and ghostty_surface_deny_clipboard_request; the read callback now receives MIME types and a permission flag and returns a ghostty_clipboard_read_result_e
Adds ExportTerminalIO action type plus set-window-title, selection-changed, move-tab-to-new-window, and open-config action tags; adds new-tab and toggle-quick-terminal IPC action tags
Moves key-binding queries from ghostty_app_key_is_binding to ghostty_config_key_is_binding; removes the translated-key member from the input trigger payload union
Updates T3TerminalView.swift to return the explicit unsupported clipboard-read result; updates build-libghostty-ios16.sh to Zig 0.16.0 and internal archive names
Risk: callers of the removed ghostty_app_key_is_binding and the old clipboard-read/confirmation callback signatures will fail to compile; the deleted ghostty/vt/osc.h header may break in-tree consumers that include it directly

^{Macroscope summarized b0a87f5.}

- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actions · 2026-09-02T01:21:29Z

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	13.1 KiB	13.3 KiB	+154 B (+1.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	6.9 KiB	6.9 KiB	−3 B (−0.0%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	6.2 KiB	6.4 KiB	+157 B (+2.5%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	54.7 KiB	55.6 KiB	+910 B (+1.6%)	66.4 KiB	✅
Codex	Live turn messages	8	10	+2 (+25.0%)	21	✅
Claude	Total thread wire	13.4 KiB	13.5 KiB	+6 B (+0.0%)	15.1 KiB	✅
Claude	Thread snapshot wire	6.9 KiB	6.9 KiB	+3 B (+0.0%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	6.6 KiB	6.6 KiB	+3 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	57.8 KiB	57.8 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	10	10	0 (0.0%)	21	✅

Baseline: 8efd4e9 · PR result: b0a87f5 · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

Codex decoded thread snapshot: 109.4 KiB
Claude decoded thread snapshot: 110.1 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

macroscopeapp · 2026-09-02T01:25:57Z

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR replaces the production iOS terminal engine with a new fork-specific native binary and updates several ABI contracts, including clipboard callbacks. Rendering, input, resizing, and clipboard behavior inside the opaque replacement library cannot be fully verified from the repository diff.

^{You can add or adjust custom eligibility rules. Learn more.}

The carried PR head compiles against the GhosttyKit.xcframework it links from apps/mobile/modules/t3-terminal/Vendor/libghostty, and upstream's GhosttyKit bump (pingdotgg#9155) changed ghostty_runtime_config_s.read_clipboard_cb from a three-argument Bool callback to a six-argument callback returning ghostty_clipboard_read_result_e. TerminalSurfaceView still passed the old closure, so the T3Code target failed to compile: TerminalSurfaceView.swift:744: contextual closure type ... expects 6 arguments, but 3 were used in closure body Return GHOSTTY_CLIPBOARD_READ_UNSUPPORTED with the new signature, matching apps/mobile/modules/t3-terminal/ios/T3TerminalView.swift. The iOS app never serves clipboard reads to the terminal, so behavior is unchanged. Fork-Feature: swift-ios Upstream: candidate Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

build(mobile): bump vendored GhosttyKit
b0a87f5
- Update GhosttyKit binaries and headers - Document the new Ghostty revision and build toolchain

github-actionsBot added vouch:trusted PR author is trusted by repo permissions or the VOUCHED list. size:XXL 1,000+ changed lines (additions + deletions). 📱 Native Change Changes the native fingerprint; merging blocks production OTAs until a new store build ships. labels Sep 2, 2026

Yash-Singh1 changed the title ~~Bump vendored GhosttyKit and update terminal integration~~chore: bump vendored GhosttyKit and update terminal integrationSep 2, 2026

Yash-Singh1 merged commit f9d1c65 into mainSep 2, 2026
22 checks passed

Yash-Singh1 deleted the yash/ghostty-bump branch September 2, 2026 05:57

Yash-Singh1 restored the yash/ghostty-bump branch September 2, 2026 05:57

patroza mentioned this pull request Sep 2, 2026
merge: sync upstream through 5392c9bb9 (3 commits) patroza/t3code#439
Merged

berghtho mentioned this pull request Sep 2, 2026
chore(upstream): sync 2026-09-02 berghtho/t3code#20
Merged

t3dotgg mentioned this pull request Sep 4, 2026
fix(mobile): clear Ghostty layer callbacks before teardown #9095
Closed