← All guides

Help / UPDATED 10 OCTOBER 2026

Troubleshoot the workflow

Resolve sign-in, repository visibility, interrupted reviews, and missing CI signals.

Sign-in does not complete

Start sign-in again from onboarding rather than reusing an old callback URL. The login flow expires after ten minutes. Allow the necessary first-party cookies. If the problem persists, the operator should verify App client credentials and the exact callback URL for this environment.

A repository is missing

Choose the correct account and use Manage repositories to check the NodeDots App installation. An organization administrator may need to approve access or new permissions. Private repositories are unavailable in this beta. Refresh the inbox after updating access.

A review is interrupted

The job page reports actual stages and failures. Retry an interrupted review from the inbox or history. New commits can supersede a captured snapshot; start a new review to capture the current head and base. An expired report cannot be restored through its old link.

Checks or approvals are unavailable

Confirm that CI ran on the report’s reviewed head. Match required names exactly. Neutral or skipped does not mean passed, and approvals for an older commit do not count as current approval. Refresh the signals, verify GitHub permissions, or inspect GitHub directly if a list is truncated.

A teammate cannot open the report

Confirm the owner granted the correct username, the teammate is signed in, and the repository is available through that teammate’s NodeDots installation access. Check whether the report has expired or the grant was revoked.