Skip to content

mobile: add Phase 7-8, full PTY streaming with detach/reattach - #486

Merged
Ziinc merged 1 commit into
mainfrom
claude/mobile-pty-reattach-prd
Sep 13, 2026
Merged

mobile: add Phase 7-8, full PTY streaming with detach/reattach#486
Ziinc merged 1 commit into
mainfrom
claude/mobile-pty-reattach-prd

Conversation

@Ziinc

@Ziinc Ziinc commented Sep 13, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • Adds Phase 7 to prds/mobile.md: a mobile-first, full interactive PTY over the SSH connection — real-time bidirectional streaming, resize, and detach/reattach across app suspension, dropped connections, and relaunches. Covers three layers: a shared VM-local pty-remote supervisor (tmux/screen-backed or a custom fallback), PTY primitives in crates/treq-mobile-ssh, and the native-module/TerminalScreen work on the RN side.
  • Adds Phase 8: desktop parity once the shared supervisor exists, extending the existing core::remote_pty/commands/remote_pty_commands.rs with list/attach-by-session-id and retiring remote-ssh.md's "terminal reconnect may be explicitly unsupported" carve-out.
  • Updates Goals, the "Terminal UX" mobile-specific-concerns section, acceptance criteria, and open questions to reflect that a full PTY (not just agent-remote polling) is now an explicit, required capability.
    This is a PRD-only change — no code in this PR. Implementation is expected to follow in subsequent PRs against Phase 7 first, then Phase 8.

Note on base branch

This PR is stacked on claude/mobile-prd-phases-7-8-270lv4 (the Phase 5/6 closure work), which is not yet merged to main. Once that one merges, this PR's diff will narrow to just the Phase 7/8 addition; retarget the base to main at that point if it doesn't rebase automatically.

Test plan

  • Documentation-only change; no tests to run.
    Generated by Claude Code

Base automatically changed from claude/mobile-prd-phases-7-8-270lv4 to main September 13, 2026 10:00
Structured agent-remote polling (Phase 4) covers agent lifecycle but not
a real interactive terminal - some agent TUIs and ad hoc shell use need
raw PTY streaming, resize, and the ability to detach without killing the
remote process and reattach later (after a suspend, a dropped
connection, or an app relaunch).

Adds Phase 7 (mobile-first PTY client: SSH crate PTY primitives, native
module streaming bridge, TerminalScreen with reattach) and Phase 8
(desktop parity, once the shared VM-local pty-remote supervisor from
Phase 7 exists), plus corresponding goals, Terminal UX updates,
acceptance criterion, and open questions.
@Ziinc
Ziinc force-pushed the claude/mobile-pty-reattach-prd branch from a49c1d1 to c512e22 Compare September 13, 2026 10:01
@Ziinc Ziinc changed the title prds/mobile: add Phase 7-8, full PTY streaming with detach/reattach prdmobile: add Phase 7-8, full PTY streaming with detach/reattach Sep 13, 2026
@Ziinc Ziinc changed the title prdmobile: add Phase 7-8, full PTY streaming with detach/reattach mobile: add Phase 7-8, full PTY streaming with detach/reattach Sep 13, 2026
@Ziinc
Ziinc merged commit 704b752 into main Sep 13, 2026
8 of 9 checks passed
@Ziinc
Ziinc deleted the claude/mobile-pty-reattach-prd branch September 13, 2026 18:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants