Repository navigation
Troubleshooting
Paste into Terminal on the Mac with the problem:
curl -fsSL https://raw.githubusercontent.com/konuksev/Pofyland/main/doctor.sh | shIt 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 (
claudefound, marketplacepofyland, pluginpofy-live@pofylandinstalled 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.
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 -- --fixThen restart the Claude sessions that were open and the Claude app. New sessions come into the sea.
- Pofyland menu → Setup steps → is "Claude plugin" done?
- Sessions opened before the plugin install need a restart.
- Is
claudeinstalled as a command? The Claude desktop app alone doesn't install the plugin. Install withcurl -fsSL https://claude.ai/install.sh | bash, then repair as above. - Still nothing: run the diagnose script and look for the first ✗.
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.
Web push only works from the Home Screen icon: Safari → Share → Add to Home Screen, open it from there, allow notifications.
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.
Quit Pofyland and open it again; it reinstalls the background server. Logs: ~/Library/Logs/pofy-aqua.log and ~/Library/Logs/pofy-aqua-install.log.
See ~/Library/Logs/pofy-update.log, or simply run the install command again.
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.
| 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.
Install · Releases · Issues · Discussions · Telegram