Make sure the Partykit server is running (deployed or local npx partykit dev)
Check that NEXT_PUBLIC_PARTYKIT_HOST matches the actual Partykit URL (no trailing slash, no https:// prefix for Partykit cloud)
Run the connect command again — it's safe to reconnect
"MCP server not found" when connecting Claude Code
Run npx claude-squad-skill connect (not claude-squad-skill directly) — the npx prefix ensures you get the latest version
If Claude Code isn't installed, the CLI falls back to API key mode automatically
Supabase auth callback fails
Confirm the Authorization callback URL in your GitHub OAuth App matches the URL of your deployed app exactly (including https://)
For local dev, make sure you've added http://localhost:3000/auth/callback as a second callback URL in the OAuth App
Merge sequence fails / PR not created
The user who clicks "Approve & Build" must have their GitHub token stored — make sure they authenticated with GitHub OAuth (not magic link) when signing in
The repo must exist and the user must have write access
Agents not receiving tasks
Confirm the agent is online in the presence sidebar (green dot)
If the agent disconnects mid-session, run the connect command again to reconnect and it will reclaim its assigned tasks automatically