Follow Discord
Sweep 22 Oct 2026 · 04:32Z Build v2.1.308 527 read Stable v2.1.308 Latest v2.1.308 Next v2.1.308 Feeds RSS JSON llms.txt llms-full.txt Unofficial
HomeDocsClaude Code CLI 22 Oct 2026
One change · claude-code

Troubleshoot a mod changedplugins/mods/troubleshoot

Nearest release: v2.1.308, published 3 hours after upstream edited the page. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Upstream edited this page at 22 Oct 2026 00:39 UTC, give or take a minute or two: the time comes from Anthropic’s own sitemap rather than from a commit. This site recorded the change at 22 Oct 2026 01:07 UTC.

Upstream edited
Recorded here
Lines+11added
Lines−0removed
From line 84 where the diff opens
First seen 1 Oct 2026 this site's first read of the page
Recorded edits20to this page, all time

### `the parser stopped` or `the engine ran out of stack loading the file`

The whole hunk

from line 84, old and new numbered
/
lines
from line 84
8484 
8585Fix the error the reason names.
8686 
87If the reason ends with `; the version loaded before is unloaded`, no version of the mod is running now. Once you fix the error, run [`/reload-plugins`](/docs/en/plugins/cli-reference#reload-plugins) in the session to load the mod again. If you installed the mod and didn't write it, ask its author to fix the error.
88 
8789### `options do not fit plugin.json userConfig`
8890 
8991The line starts with the mod's name, then `hooks module did not load: options do not fit plugin.json userConfig:` and a reason. An option fails validation against its [`userConfig`](/docs/en/plugins/components#user-configuration) field, such as a number above the field's `max`, or a required field has no value.
from line 97
9597The line starts with the mod's name, then `hooks module did not load:`, the file, and `code nested too deep to scan: more than 2000 scopes`. A file in a hooks module can't nest scopes, such as functions, blocks, and loops, more than [2,000 deep](/docs/en/plugins/mods/reference#limits). [`claude plugin validate`](/docs/en/plugins/mods/create#check-what-claude-code-reads-from-your-mod) reports the same reason.
9698 
9799Rewrite the code so its scopes nest less deeply.
100 
101### `the parser stopped` or `the engine ran out of stack loading the file`
102 
103Code in one file of the hooks module is nested so deeply that Claude Code ran out of stack reading it. The line starts with the mod's name and `hooks module did not load:`, then gives that file's name and one of these reasons:
104 
105* `code nested too deep to scan (the parser stopped: <message>)`
106* `the engine ran out of stack loading the file (code nested too deep): <message>`
107 
108The reason gives no line number and doesn't say what kind of code is nested, so look through the file yourself for its most deeply nested part. Rewrite that part to nest less. If you installed the mod and didn't write it, ask its author to.
98109 
99110### No mod loads in a directory you opened for the first time
100111 
Feedback