Troubleshooting

My phone can't reach my computer#

In project tabs, connection controls appear at the bottom while the environment is disconnected. Connecting shows an attempt in progress; Retry lets you reconnect before the countdown finishes. The controls disappear when connected. If the environment is off on this device, tap Turn On. If pairing was revoked, tap View Environment to pair again.

1. Check the host is running. On the computer, run npx @repogo/host status. If it's stopped, run npx @repogo/host start.
2. Check the computer is awake. A sleeping Mac doesn't answer. See Keep your Mac awake.
3. Check it's online. The host needs an internet connection to reach the relay. It doesn't need to be on the same network as your phone.
4. Look at the logs. npx @repogo/host logs shows what the host is doing and any errors.

The app says No Longer Paired#

The computer no longer recognizes this phone, usually because it was removed with npx @repogo/host devices revoke, or ~/.repogo was deleted. The app stops reconnecting until you pair again. Run npx @repogo/host pair on the computer and scan the new code.

An environment says Needs Pro#

RepoGo Free connects to one environment. If you paired more while on Pro, the others wait with Needs Pro; your chats and projects there are safe. See Free and Pro.

Send says I've used today's messages#

RepoGo Free includes 100 messages a day. Your prompt stays in the composer; send it after midnight, or upgrade to RepoGo Pro, which has no daily limit. Running turns finish either way.

The pairing code expired#

Codes last two minutes and work once. Run npx @repogo/host pair for a new one.

I updated RepoGo and my computer disappeared#

Hosts from the previous version of RepoGo, including the RepoGo Host Mac app, don't work with this one. Install the new host with npx @repogo/host and pair again.

An agent won't start#

The host runs the Claude Code and Codex installed on your computer, signed in as you. Open the environment in Settings → Environments and check the Agents section: you can install, update and sign in to each agent from there. Or, in a terminal on that computer, check that claude or codex runs and is signed in.

My Claude Code or Codex sessions from the computer don't show up#

The host learns about sessions you run outside RepoGo through hooks it adds to ~/.claude/settings.json and ~/.codex/hooks.json. Codex asks you to trust them once: run codex, then /hooks.

Storage on your phone#

Settings’ Storage section shows available device space and RepoGo’s usage. It is read-only; there is no device-wide purge action.

RepoGo keeps local caches and state such as unsent prompts, editor buffers, browser tabs, bookmarks and website logins. Your environments hold your projects and chat history.

Still stuck#

Send feedback from the app, or report a problem at github.com/repogoapp/host/issues. Including the output of npx @repogo/host logs helps.