Skip to content

docs: redraw the architecture diagram around the three layers - #129

Merged
Derrors merged 1 commit into
mainfrom
docs/architecture-diagram
Nov 15, 2026
Merged

Derrors merged 1 commit into
mainfrom
docs/architecture-diagram

Conversation

@Derrors

@Derrors Derrors commented Nov 15, 2026

Copy link
Copy Markdown
Owner

After #128 the architecture diagram had new labels but the old structure: only the MCP path into the daemon, nothing for the control page or remote access. It now matches the positioning in the README.

  • Access: AI client → iphone-control mcp (stdio) → daemon; the control page (iphone-control viewer, dashed, marked optional) → daemon, serving the live picture, AI tasks and HTTP MCP at /mcp, reached by browsers and remote agents over HTTPS with a login.
  • Core: the daemon, "owns the phone, runs with the page closed", with two routes — Native control (iOS 27+ · default: accessibility service, HID, CoreDevice; nothing installed, no Apple ID) and WebDriverAgent (iOS 17–26: signed with a free Apple ID, re-signed) — and Tasks and supervisor (pause, take over, confirm before risky steps; reconnect, disk image, unlock, notify).
  • Phone: "iOS 27+: nothing to install", "iOS 17–26: WebDriverAgent". Outbound HTTPS: Apple ID (WDA only), Bark, Telegram.
  • Light and dark versions are generated from one layout with the same palettes as before; the aria-label and the alt texts in README (en, zh) and What is iphone-control (en, zh) describe the new diagram.

Tested: rendered both SVGs to check every label fits its box; pnpm docs:build passes.

🤖 Generated with Claude Code

The diagram only showed the MCP path into the daemon, with relabelled
cards. It now shows the three layers: access (AI clients through
iphone-control mcp; the optional control page, which also serves browsers
and remote agents over HTTPS and HTTP MCP), and the daemon as the core,
with native control (iOS 27+, default) and WebDriverAgent (iOS 17-26) as
its two routes and tasks and supervision beside them. Light and dark come
from one layout. The alt texts in README and the guide follow.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Derrors
Derrors merged commit ac4a6d3 into main Nov 15, 2026
8 checks passed
@Derrors
Derrors deleted the docs/architecture-diagram branch November 16, 2026 02:21
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.

1 participant