Help

Support and setup

Setup, everyday use and troubleshooting, and how to reach the developer.

Contact support. Email brettcpollak@gmail.com. Developer: Brett Pollak. Replies typically within two business days. Please do not send pairing codes, tokens or passwords.

What you need

No computer nearby? Choose Try the demo on the first screen to explore the app with sample data. Nothing runs on a computer in demo mode.

Install Pocket Relay Bridge

Pocket Relay Bridge is a small free companion that runs on your computer and connects the app to Google Antigravity. Install Google Antigravity and its command-line tool first and sign in. Then run one command on the computer.

Mac or Linux

Open Terminal and paste:

curl -fsSL https://raw.githubusercontent.com/bpollak/pocket-relay-bridge/main/install.sh | bash

Windows

Open PowerShell and paste:

irm https://raw.githubusercontent.com/bpollak/pocket-relay-bridge/main/install.ps1 | iex

The installer puts the bridge in your home folder, sets it to start when you log in, and adds the Pocket Relay panel to Antigravity. It does not need administrator rights. The source, a description of each step and removal instructions are at github.com/bpollak/pocket-relay-bridge.

Pair with your computer

Scan a QR code (fastest)

  1. On your computer, open the Pocket Relay panel in Antigravity, or choose “Pair iPhone or iPad…” from the Pocket Relay Bridge menu bar icon. A pairing QR code appears.
  2. Open Pocket Relay on your iPhone or iPad and tap Scan QR Code.
  3. Point the camera at the code. The app asks for camera access the first time; the camera is used only for this. You can also scan the code with the iPhone Camera app.

Enter a 6‑digit code

  1. Connect your device and your computer to the same Wi‑Fi network.
  2. In the app, pick your computer from the list of nearby computers. A pairing page opens on your computer with a 6‑digit code.
  3. Enter the code in the app. Codes last 10 minutes.

Using the app

What does the bar at the top of the chat mean?

It shows what your agent is doing in a few words, such as “Thinking”, “Reading files”, “Editing files” or “Running a command”, with a count of the steps so far. When it reads “Needs your approval” or “Has a question for you”, tap it to jump to the request.

How do approvals work?

When the agent wants to run a command or change something, a card shows what it wants to do. Deny refuses it, Allow Once permits this one action, and Always permits that kind of action from then on. You can change how often the agent asks from the policy control at the top of the chat.

Where did the commands and code go?

Each reply summarises the agent’s work in one line, such as “Completed 4 steps”. Tap the line to see a short list of the steps. The full output stays on your computer.

How do I stop the agent?

Tap the red stop button beside the message box while it is working.

How do I dictate?

Tap the Voice Mode button beside the message box and allow microphone and speech recognition access when asked.

How do I put the keyboard away?

Tap the conversation, or drag the conversation downward.

Can I turn the animated character off?

Yes. Open Settings in the app and switch off Animated Character under App Preferences. A plain icon is shown instead.

Troubleshooting

The app cannot reach my computer

Check that the computer is turned on and awake. A computer that is asleep cannot be reached. Then check that Google Antigravity and Pocket Relay Bridge are running on it, and that your device is on the same Wi‑Fi or the same private network as the computer.

My computer is not in the nearby list

The nearby list shows computers on the same Wi‑Fi as your device. Make sure both are on the same network and that Pocket Relay has Local Network access in the Settings app. Guest and some office networks block devices from seeing each other; pair by scanning the QR code instead.

The code was not accepted

Pairing codes last 10 minutes and work once. If yours has expired, pick your computer in the app again to get a new code, then enter that one.

The camera will not scan the code

Check that Pocket Relay has Camera access in the Settings app, raise the screen brightness on your computer, and hold the device steady about a hand’s length from the code.

The agent stopped with a problem

The status bar turns grey and reads “Stopped with a problem”. The message from your computer is shown in the chat. Check the agent on your computer, then send your request again.

Managing computers and data

Remove a computer

In the app, open Manage Hosts and delete the computer. This removes that computer and its pairing from the app.

Remove everything

Delete the app to remove everything it has stored on your device. Conversation history kept by the companion stays on your computer until you remove it there.

Where does my data go?

Between your device and your own computer. See the privacy policy.

About

Pocket Relay is an independent app. It is not affiliated with, endorsed by or sponsored by Google. Google and Antigravity are trademarks of Google LLC.