| "claude.exe not found" screen on startup |
Install Claude Code, or set the path in ⚙ Settings |
| Generated files don't open in an editor |
Set your editor path in ⚙ Settings (auto-detects Notepad++, VS Code, falls back to Notepad) |
| Window closes instantly with an error |
Check %TEMP%\claudectl_crash.log — the crash handler writes the traceback there |
| Projects missing from the list |
The project folder was moved/deleted, or the path can't be decoded — see Session encoding |
| Wrong account / want a second account |
Set Config dir in ⚙ Settings to that account's CLAUDE_CONFIG_DIR (e.g. ~/.claude-work). Drives both session browsing and the env handed to claude at launch. Blank = default ~/.claude. Restart claudectl to apply. See Multiple accounts for running two at once. |
| Settings location |
~/.claude/claudectl.json — safe to edit by hand or delete to reset (always read from ~/.claude, independent of Config dir) |
| Usage stats look stale |
Delete ~/.claude/claudectl-stats-cache.json — it rebuilds on the next scan |
| GUI window tears or flickers |
Set stage: lite in Settings first; if it persists, stage: off, or launch with QTWEBENGINE_CHROMIUM_FLAGS=--disable-gpu-compositing |
| OmniRoute free execution not working |
See the Plan → Execute troubleshooting section |
| Something failed and said nothing |
Open ⚙ Logs (TUI) or the Logs page (GUI). Background jobs, the auto-memory scheduler and claudectl's own Claude calls all record their failures there |
| "No output from Claude" when generating an agent / skill / CLAUDE.md |
Usually the account's limit. claudectl now says so by name and offers another account — see Rate limits and a second account |
| An AI feature refuses to run |
The active account's session or weekly window is full. Pick another account when asked, set headless_quota to auto, or to off to launch regardless |