Guides
What you can do from your phone
Once your phone is connected to your PC, you can keep working while you're away from your desk.
- Browse the connected PC's projects and sessions
- Watch and type into in-app terminals
- Read Switcher chats, send messages, and answer approval requests
- Start new sessions, reopen past ones, and rename or archive sessions
- Change a project's tool, connection, and model settings
- See usage stats across your PCs
Creating new accounts for a tool, or starting sign-in with one, can only be done on the PC.
Which phone app to use
| App | Status | Where to get it |
|---|---|---|
| Web app (PWA) | Available | https://app.switchboard.twentyoz.kr |
| Android app | Available (APK) | Android tab on the download page |
| iPhone app | Coming soon | Use the web app until it's out |
Web app
Open https://app.switchboard.twentyoz.kr in your phone's browser and you're ready to go, no install needed. Use Add to Home screen in the browser menu to keep it on your home screen like an app.
Android app
- On the download page, choose the Android tab and download
Agent-Switchboard-Android-<version>.apk. - Open the file to install it. If your browser or file manager asks for permission to install apps, allow it.
If you previously installed an APK signed with a different key, the new one can't install over it. Uninstall the old app, install the new APK, then reconnect to your PC and sign in with Google again.
Turn on phone connection on your PC
Phone connection is off by default.
- On your PC, open 환경 설정 › 휴대폰 (Settings › Phone).
- Switch on 휴대폰 연결 켜기 (Turn on phone connection).
Even with it on, your PC only makes outbound connections to the relay server and never opens a port. If the PC can't use the OS secure storage, you won't be able to turn phone connection on.
Option 1: QR code
This works without a Google account.
- On your PC, go to 환경 설정 › 휴대폰 › 새 휴대폰 연결 (Settings › Phone › Connect a new phone) and click 연결 QR 만들기 (Create connection QR). The QR code is only available once the PC is connected to the relay server.
- In the phone app, go to PC 연결 (Connect PC), tap QR 코드 스캔 (Scan QR code), and scan the code on your PC screen. If you can't use the camera, click 주소 복사 (Copy address) on the PC and use 연결 링크 붙여넣기 (Paste connection link) on the phone.
- Your phone shows a 6-digit number. Check that it matches the number in the approval dialog on your PC, then approve.
Each QR code works once and expires after 5 minutes. If it has expired or been used, make a new one.
Option 2: Google account
Sign in to the same Google account on your PC and phone, and you can connect without a QR code.
- On your PC, sign in with Google from the account menu at the bottom left or from 내 컴퓨터 (My computers) in the rail. You can also check the status under Google 계정 · PC 목록 동기화 (Google account · PC list sync) in Settings › Phone.
- In the phone app, sign in with the same Google account.
- Your phone lists the PCs on that account, including ones that are switched off. Tap a PC to connect, no QR code needed.
Decide whether to skip approval
You'll find these options under 환경 설정 › 휴대폰 › 대시보드·세션 접근 권한 (Settings › Phone › Dashboard and session access).
- 같은 계정 휴대폰·웹 자동 허용 (Auto-allow phones and web on the same account): When on, a new phone signed in with the same Google account connects without the number check. When off, you approve it on the PC the first time it connects.
- 같은 계정 다른 PC 자동 허용 (Auto-allow other PCs on the same account): Controls whether another PC on the same account can open this one from My computers in the rail without an approval dialog. A connected PC can type into this PC's terminals, so only turn this on if every PC involved is one you manage yourself.
Even with auto-allow on, you'll still need to confirm the number in the PC's approval dialog when:
- A device you disconnected or signed out from this PC tries to come back
- More than 3 different devices try to register automatically within an hour
Whenever a new device joins on your account, you'll get a PC notification and an entry in the activity log.
Your PC makes the call
The account server only keeps the list of PCs; it never approves connections. Your PC checks the Google sign-in proof from the phone itself. So even if someone tampered with the list on the account server, they still couldn't get access to your PC's terminals.
Notifications
The Android app can notify you about pending approvals, finished tasks, and errors. Register for notifications in the phone app, then on your PC go to 환경 설정 › 휴대폰 › 연결한 휴대폰 (Settings › Phone › Connected phones) and turn 작업 완료 알림 (Task completion notifications) on or off for each device. Approval requests, new device connections, and errors are always notified, whatever this setting says.
Your PC encrypts each notification with a per-device key that the phone created. The relay server and the Apple and Google push services only see a push token and ciphertext. If the phone can't decrypt a notification, it shows a fixed message: "There is something to check." Devices that have the app open and connected don't get notifications.
What the relay server can see
Everything between your phone and PC is end-to-end encrypted, so the relay server just passes ciphertext along.
What the server can't see
- Terminal input and output
- Switcher chat content
- Pairing secrets and session keys
- API keys and OAuth tokens
- Your email address and Google tokens (they're received to verify sign-in but never stored)
What the server does handle
- Connecting IP addresses (to prevent abuse and keep access logs)
- PC room identifiers (derived from the PC's public key), plus the size and timing of encrypted data
- If you use a Google account: your account identifier; each PC's public key, name, and last connection time; each phone's device ID, name, and platform; and session hashes
- If usage sync is on: encrypted monthly usage bundles
How the encryption works
- The one-time secret in the QR code sits in the URL fragment, so it never reaches the server.
- Both sides create a fresh session key every time they connect. If the relay server tried to step in the middle, the keys wouldn't match and the connection would fail.
- The relay server doesn't store or keep messages.
For details on how data is handled, see the Privacy Policy.
Managing connected devices
Under Settings › Phone › Connected phones, you can do the following for each device.
- 이름 바꾸기 (Rename): Changes the name in this PC's list only.
- 연결 끊기 (Disconnect): Disconnects it from this PC only. To come back, the device has to reconnect with a new QR code or go through this PC's approval dialog.
- 로그아웃 (Sign out), for devices that joined with a Google account: Signs that phone out of the account and disconnects it from every PC on the account.
- 모두 끊기 (Disconnect all): Disconnects every phone connected to this PC.
데스크톱 신원을 새로 만들면 (If you create a new desktop identity), every connected phone is disconnected and the desktop fingerprint changes. The PC is also signed out of your Google account.
Combined usage across PCs
Turn on 여러 PC 사용량 합쳐 보기 (Combine usage across PCs) under Settings › Phone, and token counts by date, tool, model, and project are stored on the account server, encrypted with a key that only your account's devices know. Chat content is never uploaded. See the combined numbers in the phone's stats and under 모든 PC (All PCs) in the PC overview.
Stored records stay until you delete them. To delete them, use 서버에서 이 PC 기록 지우기 (Delete this PC's records from the server) or 계정 사용량 기록 모두 지우기 (Delete all account usage records).
Running your own relay server
Out of the box, the app uses the official relay server and phone app address. Under 환경 설정 › 휴대폰 › 주소 (Settings › Phone › Addresses), you can switch to a relay server you run yourself (a wss:// address) and a phone app you host (an https:// address). Clear the fields and save to go back to the official addresses. Only enter a phone app address you trust: the app at that address will be able to type into this PC's terminals.
If you can't connect, see Troubleshooting.