[lauridskern]

Restructures the repo as an npm workspace so the server and UI can be shared across hosts. It also merges Mike's Claude Desktop support (#34) into that layout and adds a standalone Mac app.

Repository layout

Path	Contents
packages/shared	Protocol types and pure logic
packages/core	MCP server, device runtimes, tool handlers
packages/ui	Host-independent React views and panel controllers
packages/mcp-app	The MCP Apps panel shell that Codex, Claude Desktop and other MCP Apps hosts load
packages/skills	Agent skills for the shared tools
packages/test-support	Fixtures shared by tests across packages
packages/native	Native helper sources, prebuilt binaries in vendor/
packages/runtimes	Pinned agent-device and serve-emu runtimes
apps/codex-plugin	Codex manifest, launcher, assets, plus its server (updater) and panel (update banner)
apps/claude-desktop	Claude Desktop MCPB manifest
apps/mac	SwiftUI shell, its web page and its server
tooling	Shared build, native, release and device smoke scripts (was scripts/); each app's tooling/ holds its packaging and smoke tests

The published release/latest layout is unchanged. The packaged plugin has the same files as before; bundles differ only in path comments and Sentry debug IDs.

Claude Desktop (#34)

Mike's branch is merged with his history kept. It adds a Claude manifest, .mcpb packaging, capability-driven host behavior (fullscreen, inline sizing, theme tokens and fonts, context attachments, clipboard), annotation drafts and log session handles. Fitting it to the workspace layout took three changes:

• Panel shell: the MCP Apps shell moved from apps/codex-plugin/src to packages/mcp-app, because both Codex and Claude Desktop load it. Mike's display-mode and context-attachment controls moved there with it.
• Claude files: the manifest is in apps/claude-desktop, and claude:config, package:claude and test:claude run from tooling/.
• Shared code: Mike's shared changes (chat-message, standard MCP context attachments) use HostBridge, and PanelContext still accepts no OpenAI extensions for the Mac app.

The Cursor (#35) and VS Code (#36) PRs are not included. Mike closed both to restart them after #34.

Shared UI seam

• Shared views depend on HostBridge (packages/ui/src/host-bridge.ts), the seven App operations they use. Codex passes its ext-apps App.
• DeviceWorkspace takes over the iOS/Android panel orchestration from the Codex shell, so both hosts share it.
• The server exports configureUI. It serves ui://mobile-dev/mac.html only when a runtime ships mac.html, which the Codex package doesn't.
• Page bundling moves to tooling/ui-page.mjs.
• Telemetry: UI and server carry a host tag: codex, claude, mac or other.
  • MCP Apps panels label themselves once connected: codex when the host advertises OpenAI extensions, otherwise the mapped host name.
  • The server labels itself from the MCP client name. The Mac app also sets MOBILE_DEV_HOST=mac.
  • The allowlist accepts only those values, so raw host and client names are never sent.
  • Only telemetry uses the label; behavior still follows capabilities. Tests cover both sides and docs/telemetry.md documents it.

Host separation

Adding a host now means adding an app; the shared packages know no host by name.

• Server: runStdioServer takes a host's ServerFeatures. Codex's self-updater moved to apps/codex-plugin/server and the Mac page resource to apps/mac/server, so the shared server and the Claude bundle no longer carry them.
• Panel: startMcpApp takes a host's workspace chrome. The update banner moved to apps/codex-plugin/ui; Claude loads the shared entry.
• Views: packages/ui names context attachments (HostAttachments) instead of depending on @openai/mcp-extensions.
• Build and version: dist/ holds the host-neutral runtime and panel, and host pieces build into dist/hosts/<host>. Each app packages from the runtime only; Claude no longer packages through Codex. The version comes from the root package.json, and each package step writes it into its host's manifest.
• Skills: the product skills are in packages/skills, and Codex packages the ones it supports. build-codex-native-plugins is a repo-maintenance skill and moved to .agents/skills.
• Shared: packages/shared no longer imports vendored runtimes; a test keeps its copied constants equal to the originals.
• Tests: each package and app has a test/ folder, and shared fixtures live in packages/test-support.
• Sentry: the projects are renamed to mobile-dev-ui, mobile-dev-server and mobile-dev-native (done in Sentry already). IDs and DSNs are unchanged, so history and events stay put. The slugs live in tooling/sentry-projects.mjs.

Review cleanup

A strict code-quality pass before merge removed duplication the restructure had left:

• WorkspaceTools (packages/ui) owns the four tool panels, their show/close policy, availability, host changes and disposal. The Codex workspace and the Mac page only pick the tool and draw chrome. On the Mac, switching away from Performance now keeps capture running, like Codex; closing the tools stops it.
• startCardApp runs the recording, comparison and TraceSift cards, and applyHostStyles replaces four copies of host theming. Three entry files are gone, and a new test covers every card's connect, theme, render and teardown.
• createPlugin takes named options instead of seven positional ones.
• Codex's server and panel build in the Codex package step, like the Mac app's. The shared build no longer imports an app, and dist/hosts is gone.

Mac app

• Window: SwiftUI with a native sidebar (tools, iOS/Android toggles, server status). The content area is a web view with the shared views, without the Codex toolbar or title bar. It reaches the window's top edge and stays clear of the traffic lights when the sidebar is collapsed. Minimum size is 1280×720.
• Server: runs over stdio exactly as in Codex and relays JSON-RPC to the page. Before the page connects, the app fetches the page through MCP, so it gets the server-owned telemetry environment, opt-out and anonymous identity. The page has no chat capabilities, so chat-only actions stay hidden.
• Build: npm run build:mac writes release/mac/Mobile Dev.app, signed ad hoc and linked against the current macOS SDK. npm run test:mac launches it, waits for the page to connect and draw, and checks that quitting stops the server.

Before merging / after pulling

• Native hashes: native sources are pure renames (R100), but their recorded source hashes include repo paths and build-script text, so they were re-recorded without rebuilding binaries.
  • After pulling, run npm run rebuild:baguette once. Its hash lives in the untracked vendor/baguette/release.json.
  • CI will rebuild the native helpers on the next release because their artifact keys changed.
• Repo name: the repository is now callstackincubator/mobile-dev (renamed on GitHub). GitHub redirects the old URL for git, the API and raw files, so released versions keep updating. The updater accepts both the old and the new marketplace URL, and a test covers installs made before the rename. Links and the README install command use the new name.

Not included

• Mac distribution: Developer ID signing, notarization, and source-map upload for the Mac page.
• Native Sentry for the Swift shell.
• Agent connections to the Mac app.

Verification

• npm test: 822 pass. packages/core/test/tracesift-client.test.ts fails intermittently: about 5 in 24 runs under parallel load, with an undici ReadableStream is already closed error. It does the same on main. CI on PRs doesn't run tests, but the release job does. tests/tracesift-client.test.ts is intermittently flaky (undici stream state) both on this branch and before the restructure.
• npm run typecheck:telemetry is clean. A full tsc run reports 23 errors, fewer than the 25 main had.
• The Codex package smoke test now checks that the updater and banner are present; the Claude smoke test checks that both are absent.
• npm run test:package, npm run test:codex-plugin (real Codex install) and npm run check:mcp-budget pass.
• npm run package:claude and npm run test:claude pass (relocated bundle, development and release, with and without form elicitation).
• npm run build:mac and npm run test:mac pass, with live iOS simulator and Android emulator streams in the app.

Merging

Use Create a merge commit. #34's head commit is in this branch, so GitHub marks #34 as merged only with a merge commit; squash or rebase leaves it open. #35 and #36 were already closed by their author.

[grabbou]

Shall we first squash merge #34 into main, and then, rebase/merge this one? that way we can ship Claude a bit sooner