Remote Browser Setup

Live screen remote · Mac to phone

See and control your Mac from your phone.

Scan with the phoneQR code that opens the Codee Remote screen viewer on a phoneOpen screen viewer

Codee Remote is a real screen remote. View your Mac display, move the pointer, click, scroll, type with the phone keyboard, or dictate text with your phone microphone.

Live Mac screenTouch mouseKeyboard and voiceEmergency stop

No unsigned Mac app is opened. Setup uses readable, fingerprint-verified Python source. macOS still asks you to approve Screen Recording and optional Accessibility control.

View All Setup Steps
Scan with the phoneQR code that opens the Codee Remote screen viewer on a phone

This opens the screen viewer. After the Mac connects, a private session QR fills in the secure pairing automatically.

Open viewer on this device

Four large setup buttons

Set up the Mac once. Use the phone afterward.

Open Terminal using Spotlight. Press a Copy button, paste into Terminal, and press Return. The button copies text only—it will not open VS Code or another app.

1Prepare the screen remote

Copy this setup text, paste it into Terminal, and press Return. Terminal performs the verified download and installation for you.

See exactly what Terminal will run
mkdir -p "$HOME/.local/share/codee-remote"
curl -fL --retry 2 "https://clients.codee.chat/assets/downloads/codee-remote-host.py" -o "$HOME/.local/share/codee-remote/codee-remote-host.py"
echo "HOST_SHA256  $HOME/.local/share/codee-remote/codee-remote-host.py" | shasum -a 256 -c -
python3 "$HOME/.local/share/codee-remote/codee-remote-host.py" install "$PWD" --write
python3 "$HOME/.local/share/codee-remote/codee-remote-host.py" toolbox "$PWD" --write

2Secure sign-in

Terminal privately asks for the owner token and saves it in macOS Keychain.

See the Keychain command
security add-generic-password -U -a "$USER" -s "AIK9-Codee-Remote" -w

3Start the screen remote

Terminal opens the Mac host page and shows a private session QR. Scan it, then press Start Sharing This Mac and choose the screen.

See the connection command
python3 "$HOME/.local/share/codee-remote/codee-remote-host.py" cloud-start "$PWD" --device-name "My Mac"
python3 "$HOME/.local/share/codee-remote/codee-remote-host.py" service-install "$PWD"

4Optional full control

Enable phone mouse, keyboard, and reviewed voice text. macOS will ask for Accessibility approval.

See the locally compiled control command
python3 "$HOME/.local/share/codee-remote/codee-remote-host.py" native-setup "$PWD" --enable
open "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility"

Screen

See the Mac live

The phone viewer receives the screen or window you visibly choose on the Mac.

live

Phone control

Mouse, keyboard, and voice

Move, click, scroll, type, or dictate reviewed text after optional Accessibility approval.

live

Safety

Stop from either device

The Mac owns screen consent. Both devices keep an emergency stop available.

live

Advanced: Codee CLI commands from the phone

The screen remote is the main product. After pairing, the same viewer can also request four safe Codee CLI actions: Status, Heartbeat, Doctor, and Route Scan. Raw Terminal commands, secret access, and unapproved deploys remain blocked.