Troubleshooting
Fix common Nimbalyst problems, including agents not responding, provider outages, API key and login errors, sync issues, and install trouble.
This page collects fixes for the most common problems: an agent that stops responding, and crashes or freezes caused by running out of memory. For database problems, see Database Backups and Restore.
Claude or Codex is not responding: check the provider status pages first
Before you dig into Nimbalyst settings, your network, or your API key, check whether Anthropic or OpenAI is having an outage. When their APIs are degraded or down, sessions hang, time out, or return errors that look like a Nimbalyst bug but are not.
Anthropic (Claude): status.anthropic.com
OpenAI (Codex / ChatGPT): status.openai.com
If either provider is reporting an incident on the affected component (Messages API, Claude Code, Codex, etc.), the fix is to wait for them to recover. There is nothing to change on your end.
Nimbalyst is crashing: increase the heap size
If Nimbalyst is crashing, freezing, or showing out-of-memory errors (especially in large projects, long sessions, or while working with big diffs), the V8 memory limit is the likely culprit. The default heap size is 4 GB, which is enough for most projects but can be too small if you keep many sessions, tabs, or files open at once.
How to increase it:
Open Nimbalyst > Settings > Application > Advanced.
Scroll to the Tools & Environment section.
Find Max Heap Size and pick a larger value (6 GB, 8 GB, 12 GB, or 16 GB).
Restart Nimbalyst. The new limit takes effect on the next launch.
Pick the smallest size that comfortably fits your workload. Going higher than you need does not make Nimbalyst faster, it just lets V8 hold more in memory before garbage collecting. If you routinely hit the ceiling at 4 GB, 8 GB is a reasonable next step. Reach for 12 GB or 16 GB only if you work with very large repos or many parallel sessions.
If raising the heap does not fix the crashes, share details (project size, what you were doing, any error messages) via Discord or support. See Feedback, Discord, Support, Releases.
Still stuck? The Nimbalyst site has feature walkthroughs and demo videos that often show the setting you are looking for, and support is at [email protected].
Last updated