17 · Troubleshooting & recovery¶
What you'll do¶
Work through the handful of things that fix almost every "it's not working" moment — in order, quickest first — and know when it's time to get help.
Work isn't starting¶
- Is it paused? If you hit your spending cap with the pause setting on, new work stops on purpose. Raise the cap or resume work in Settings (page 3).
- Is an AI available? At least one assistant has to be set up — see page 2.
- Reload the screen. A quick reload clears most display hiccups.
A job came back "blocked"¶
This almost always means its safety check failed — the build or tests didn't pass. Open the job and read the details: the AI's work is waiting for a fix, and your project was left untouched. That's the safety net working, not a fault. Send a correction and let it try again (page 5).
A job seems frozen¶
Open it and watch the changes and chat panels. If the AI is mid-thought, you'll see movement. If it's genuinely stuck, stop it (page 5) and start again with clearer instructions.
The screen stopped updating¶
Reload it. The app reconnects and shows the current state — you won't lose anything that was running.
Most jobs are failing their checks¶
If your success rate has cratered (you'll see it on page 13), open a blocked job and read its test output — the same message the AI is working from. A run of failures usually traces back to one broken thing in the project, not the factory.
When to get help¶
If the app itself won't start, keeps crashing, or none of the above helps, it's likely something below the surface — the kind of thing whoever set up TofuFactory for you would look at. The app can package up a diagnostic report for them; see page 18 for how, and for the error and activity logs that show what the factory has been doing.
You should now see¶
- A short, ordered checklist you can run through whenever something seems off.
- A clear line between "this is the safety net doing its job" and "this needs help."
Next¶
→ 18 · Issue logs & diagnostics — the logs behind the scenes, and how to package a report.