No messages in app.messages

  • Confirm projectId + projectSecret are set for cloud mode
  • Check app.ready — the line may still be connecting
  • Verify iMessage is enabled: sky skyline platforms ls

BrokerError on startup

CodeFix
PLATFORM_NOT_ENABLEDEnable iMessage on the project
HTTP_401Rotate secret or check credentials
NO_LINESAdd a line or wait for pool allocation

Send fails with error signal

Listen on app.on("error", …) for the platform error code. Common causes: invalid handle, line not ready, or quota exceeded.

Dedicated mode won’t connect

  • Confirm gRPC endpoint is reachable over Tailscale
  • Token must match what the server expects in metadata
  • Each line needs a phone field for routing

Group operations fail on free plan

Group creation and admin are not available on the free tier. Use existing DMs only.