Remote control in BrokenCode

Your connected computer runs the work using its projects, credentials, models, MCP servers, and tools. Your phone or another browser controls the same tasks through BrokenGPT Work.

1. Install the latest BrokenCode on your Mac, Windows PC, or Linux computer.
2. Type /remote in BrokenCode to open connection controls, or open Settings → Remote access in the desktop app. In a shell, run brokencode remote to open the interactive terminal and its connection menu.
3. Choose Sign in to BrokenGPT on the computer and finish in your browser. Sign in to the same account in the native iPhone or Android app; your computer appears automatically. QR codes and connection codes remain available as a fallback.
4. Allow access on the host computer once. Select the online computer on your phone, or Open workspace in BrokenGPT Work.

brokencode remote

BrokenCode Desktop, the native iPhone and Android apps, the terminal, and your remote browser connect to the same workspace on your computer. A task started in one appears in the others, with the same messages, model selection, mode, reasoning effort, agent actions, files, and running processes.

Home shows tasks across project folders. Use All tasks to clear a project filter and search to find older tasks. In the terminal, use /sessions to choose a task from any project; the working directory follows that task.

• Select Open local folder to browse or create folders on the host computer. The native file editor saves directly to that computer and detects conflicting edits.
• Use the terminal button to open an existing host terminal. Commands and output flow in both directions, and reconnecting restores its available output history.
• Send a follow-up from either device, or select Stop to interrupt the same running task.
• This shares BrokenCode tasks and workspace terminals. BrokenGPT web chat conversations have their own history.

brokencode
brokencode web
brokencode workspace status

With v1.18.29 or later on both devices, running projects and tasks appear first in Work on iPhone and Android. A working-projects row at the top of a conversation opens the list. You can also swipe left from the right edge of the conversation to open Work and return without losing your draft.

With v1.18.29 or later on both devices, open Task notifications from the account or workspace menu. Android can receive completion and attention alerts through Firebase even when its app process is closed. Allow notifications when Android asks and keep your computer awake and online. Notification taps check your account before opening the task.

Current Xcode-installed iPhone builds provide alerts while the app is active. Background iPhone notifications require a push-capable Apple signing profile and APNs configuration; they are not enabled in the current personal-device build. Cancelled work and individual Ultra worker completions do not count as a completed team task.

BrokenCode keeps its existing desktop interface on Mac, Windows, and Linux. The native iPhone app connects to the same local projects, task history, file edits, models, and shells.

The iPhone app uses native screens for your computer list, tasks, messages, files, and terminal. Sign in to your BrokenGPT account to discover your computers. The app remembers the last computer and reconnects when it is online. Native screens follow the system appearance and keep the local project path visible. Personal-device builds can be installed with Xcode using your Apple signing team. An App Store or TestFlight download is not currently available.

• Messages arrive live in both directions. You can keep an unsent draft and scroll while the host works.
• The app follows the current task on the computer when your composer is empty. New work uses the selected local project, or the host home when no project is selected. Your unsent drafts are preserved. The terminal is a real local shell; on a Mac, cd ~/Desktop opens your Desktop from any directory.
• Windows and supported Linux desktop builds download updates in the background and install when you quit. Current Mac installers need manual update installation until Apple code signing is configured. Compatible terminal patch updates download without interrupting active tasks; the shared engine uses the new version when its workspace restarts. iPhone builds installed through Xcode must be rebuilt and reinstalled; they do not update themselves.
• To keep only the connection bridge in a terminal, use brokencode remote --headless.

brokencode remote --headless

• Start a task, continue an existing conversation, and send follow-up instructions.
• Review files, changes, tool output, and an interactive terminal running on the host.
• Use /goal, /tester, and /developer; follow saved reports and pause, edit, resume, or clear goals.
• Respond to necessary approvals and questions. Existing permissions apply, so routine work does not need a second approval just because you connected remotely.
• Computer use and signed-in applications are available when the host has the corresponding desktop tools and OS permissions.

/tester Test checkout end to end and document the failures.

/developer

Download the signed Android APK from brokengpt.com/download#android. Android 8 or later is supported. Install it on your phone and sign in to the same BrokenGPT account as your connected computer, then select the online computer. QR and connection codes are available under Use a code or QR.

The Android app uses native screens for tasks, messages, model selection, Ultra worker conversations, local folders, file edits, and a live terminal. Only account sign-in opens a web view. Your computer executes the work in its own local folders.

• Use Workspace options to open files, the live terminal, or another project. File saves detect changes made by another device and preserve your unsaved edits when a conflict occurs.
• Select Ultra in the model menu to coordinate component agents, integration, and review. Open an agent card to inspect its conversation, then use Back to coordinator to return to your draft.
• Type /remote or choose Remote connections to pair again or select another computer. Keep the host awake and connected.
• Install new APKs over the existing app to preserve sign-in and drafts. Android requires you to confirm installation. About BrokenCode includes the latest-download link.

brokencode remote

Keep remote access running and the computer awake. The shared workspace keeps tasks and terminals running when you close a local client. The desktop app can keep the computer awake while remote access is enabled. A terminal host remains active while brokencode remote is running. Exit the terminal client to disconnect its bridge while preserving pairing; brokencode remote --headless runs only the bridge for unattended hosting.

• Type /remote in the desktop, browser, terminal, or native phone app to open connection controls. On the host, choose Reconnect to resume a saved connection or Pair again to generate a fresh code. In a shell, brokencode remote pair replaces the old pairing and shows a new code.
• The remote workspace shows connection status. The native phone apps renew expired connections for the same signed-in account and computer. If access was revoked or your account signed out, sign in again. The browser also offers Reconnect.
• Tasks and reports remain on the host. Interrupted commands are never automatically resubmitted by the connection layer.
• Use brokencode workspace stop only when you want to stop the shared workspace; it interrupts active tasks and terminals. Start it again with brokencode workspace start and resume interrupted goals explicitly.

brokencode remote status

Disconnect in the remote workspace ends that browser connection without stopping the host's work. Manage access in BrokenGPT Work can revoke computers and controller devices. Turn off remote access in the desktop app, or use the terminal command below, to remove the host connection.

• No router port forwarding is required. The host makes an authenticated outbound connection.
• Pairing codes expire after ten minutes, and account connection tickets are single-use.
• Traffic is encrypted in transit. The relay processes it in memory; the connection is not end-to-end encrypted.
• Accessibility, Screen Recording, and other OS permissions require their normal consent on the host.

brokencode remote off