# iPhone Camera Bridge

> Agent-facing counterpart to the [human project page](/projects/iphone-camera-bridge/).

## Record metadata

- Record: 032
- Slug: iphone-camera-bridge
- Domain: Software
- Domain code: SW
- Type: WebRTC utility
- Status: Prototype
- Period: 2026
- Portfolio role: Interface utility
- Publication state: Public-safe technical record
- Case-study readiness: Draftable
- Compendium edition: 0.4

## Summary

A local WebRTC bridge that lets a Mac-based agent use an iPhone as a user-controlled camera.

## Overview

A coding agent on a Mac can inspect files and windows but cannot see a cable, a device label, a circuit board, or the object the user is describing. iPhone Camera Bridge gives that agent a temporary, user-controlled view into the physical scene.

A local phone page and Mac viewer that stream the iPhone camera through WebRTC after a user gesture and permission grant.

Purpose: Give an agent temporary visual access to physical objects when the user explicitly opens and permits the phone camera.

## The problem behind the project

An agent working on a Mac can inspect files and screens but cannot see a cable, device, label, or physical build without a camera bridge.

The permission model is part of the product. The phone page must be opened, the user must grant camera access, and the session should remain visible and easy to stop. Those steps prevent a useful diagnostic bridge from quietly becoming remote surveillance.

People using agents for hardware, repair, accessibility, and physical-world troubleshooting may benefit. Anyone or anything in camera view is affected.

## How it took shape

A browser-based phone capture surface, local signaling, WebRTC media transport, and a Mac-side viewer designed for deliberate, temporary sessions.

The prototype uses a browser-based phone capture surface, local signaling, WebRTC transport, and a Mac-side viewer. It proves the camera path while keeping private network details, certificates, and captured imagery outside the public case study.

Josiah identified the missing physical-vision capability, defined the user-controlled permission model, and directed agent-assisted implementation.

A working local prototype demonstrates the phone-to-Mac camera path.

## What the project means now

The project is a small but representative agent interface: it extends perception only when the user deliberately supplies it. That pattern is likely more trustworthy than treating every available sensor as ambient agent context.

It is not a general remote-surveillance system. Network details, certificates, private imagery, and unattended capture are excluded from publication.

A user gesture and visible session boundary are product features, not inconveniences, when an agent gains a camera.

Package the local setup cleanly and add unmistakable session, stop, and capture-state indicators.

## Publication and interpretation notes

- Current classification: Prototype
- Portfolio readiness: Draftable
- Publication boundary: Public-safe technical record

## Additional agent context

Describe the consentful local capability; do not publish private network details or captured imagery.

## Related project records

- [Agent Interface Experiments](/projects/agent-interface-experiments/llm/) — A family of experiments that let AI agents see, touch, navigate, and manipulate interfaces beyond a text-only shell.
- [openwyzeband](/projects/openwyzeband/llm/) — An evidence-driven BLE toolkit for understanding and eventually controlling a personally owned Wyze Band.

## Navigation

- [Complete project index](/projects/llm/)
- [Human version of this record](/projects/iphone-camera-bridge/)
- [About Josiah's working method](/about/llm/)
- [Agent discovery map](/llms.txt)