Troubleshooting
Every named failure CULP can report, what caused it, and what to do next.
Start with culp doctor. It runs every check and prints the value each one
found rather than a pass or a fail, which is usually enough on its own.
A write was refused
| Reason | Cause | Next step |
|---|---|---|
not_logged_in |
No credential on this machine. | culp login |
credential_expired |
The 180-day authorization ran out. | culp login |
device_identity |
The stored identity no longer matches this machine. | culp login |
subscription_required |
No active plan. | Subscribe from your dashboard. |
unauthorized |
The device was revoked. | culp login |
api_unreachable |
The decoder could not be reached. | Check the network. Ordinary source still works. |
invalid_response |
The decoder answered something unexpected. | Report it with the file and the time. |
decode_error |
The compact expression is wrong for that language. | Fix it, or write ordinary source. |
A refused write costs a turn and never a file. Nothing was written, so there is nothing to clean up.
A patch was refused
line_out_of_range, no_match, ambiguous_match, divergent_matches and
invalid_regex all mean the region could not be identified without guessing.
See the patch tool. Name a narrower region, or
fall back to Edit.
A file still contains compact source
CULP warning: thing.py still contains compact CULP source after this tool call
means another plugin's hook answered after CULP's and its answer won. Rewrite the
file with ordinary source. If it keeps happening, the other plugin's
PreToolUse hook is competing for the same tools.
A search answer looks like an error
It is not. See delegated search.
Nothing seems to be happening at all
Check the plan: on a free plan the paid surfaces answer with a payment-required status and the plugin tells the session, once, not to use them.
Then check the credential with culp doctor. A device whose credential is
locally unusable is reported at session start, before the first write rather
than after it.
Still stuck
support@claudeusagelimits.com. Include the output of culp doctor and, if a
write was involved, the receipt id from the message.