Skip to content

Troubleshooting

konuksev edited this page Nov 16, 2026 · 1 revision

Troubleshooting

Run the diagnose script

Paste into Terminal on the Mac with the problem:

curl -fsSL https://raw.githubusercontent.com/konuksev/Pofyland/main/doctor.sh | sh

It changes nothing. It checks and prints ✓ / ✗ for:

  • the app (installed, version, running, plugin bundled inside),
  • the background server (LaunchAgent com.poflow.pofy-aqua, answering on 127.0.0.1:7433),
  • session records written in the last 10 minutes,
  • Claude Code and the plugin (claude found, marketplace pofyland, plugin pofy-live@pofyland installed and enabled),
  • Codex and Antigravity (optional),
  • the last lines of the logs.

The output contains only paths and versions, nothing secret, so you can paste it into an issue.

Repair the plugin

The most common cause of an empty sea is the Claude plugin not being installed ("Install plugin" was skipped, or claude was missing then).

curl -fsSL https://raw.githubusercontent.com/konuksev/Pofyland/main/doctor.sh | sh -s -- --fix

Then restart the Claude sessions that were open and the Claude app. New sessions come into the sea.

Common problems

No Pofy shows up

  1. Pofyland menu → Setup steps → is "Claude plugin" done?
  2. Sessions opened before the plugin install need a restart.
  3. Is claude installed as a command? The Claude desktop app alone doesn't install the plugin. Install with curl -fsSL https://claude.ai/install.sh | bash, then repair as above.
  4. Still nothing: run the diagnose script and look for the first ✗.

The phone says "Can't reach your Mac"

Almost always the Mac went to sleep (lid closed, on battery). Keep it on power and stop sleep with the lid closed (System Settings → Battery → Options, or the power setting in Setup steps). Check Tailscale is on for both devices and signed in to the same account.

No push notifications on iPhone

Web push only works from the Home Screen icon: Safari → Share → Add to Home Screen, open it from there, allow notifications.

macOS says the app is damaged or blocked

The app isn't Apple-signed yet. Run xattr -dr com.apple.quarantine /Applications/Pofyland.app or use System Settings → Privacy & Security → Open Anyway. The install script does this for you.

"Server not answering"

Quit Pofyland and open it again; it reinstalls the background server. Logs: ~/Library/Logs/pofy-aqua.log and ~/Library/Logs/pofy-aqua-install.log.

Update failed

See ~/Library/Logs/pofy-update.log, or simply run the install command again.

Codex or Antigravity sessions don't appear

The diagnose script shows whether codex / agy are found. Pofyland doesn't install them: Codex via npm i -g @openai/codex or the ChatGPT app, Antigravity from antigravity.google.

Logs

File What
~/Library/Logs/pofy-aqua.log background server
~/Library/Logs/pofy-aqua-install.log server install on launch
~/Library/Logs/pofy-update.log one-click update

Still stuck? Open an issue with the diagnose output, or ask in the Telegram group.

Clone this wiki locally