Build & Deploy AI Agents

Troubleshooting

Tips for solving common problems.

Enrollment issues

If enrollment fails, try refreshing the page and clicking the enroll button again. Make sure JavaScript is enabled in your browser.

Progress not updating

Progress syncs between your AI agent and the website in real time. If checkmarks are not appearing, try refreshing the page. If the problem persists, check that your AI agent was able to call the progress API successfully.

How to reset progress or disenroll

Visit the disenroll page to reset your progress or fully disenroll. Resetting clears all completions while keeping your student ID and profile.

My workflow never runs

Did you re-export ReviewWorkflow from src/server.ts and bind it in wrangler.jsonc? Cloudflare does not error if you forget, the workflow just silently never starts.

REVIEWBOT says it does not have a tool

Tools live in src/tools/, but they only become callable once you add them to the tools map inside onChatMessage. Easy to miss.

GitHub API returns 403

You have hit the unauthenticated rate limit (60 requests/hour/IP). Wait an hour, or run wrangler secret put GITHUB_TOKEN with a token that has public_repo scope to raise it to 5000/hour.

The findings panel is empty

State updates flow over the agent WebSocket. Open DevTools, Network, and look for the /agents/... connection. If it is disconnected, refresh the page.

I am stuck on a module

Every module has a git checkpoint. Recover the canonical source while keeping your notes by overlaying just src/:

git checkout checkpoint-N-name -- src/

Checkpoints: checkpoint-0-starter, checkpoint-1-foundations, checkpoint-2-tools-ai, checkpoint-3-workflows, checkpoint-4-hitl-schedule, checkpoint-5-mcp.