Troubleshooting

Common issues and solutions.

lfd daemon not running

Symptom: lfq shows nothing or errors.

Check if installed:

launchctl list | grep lfd

Reinstall:

lfd install

Run in foreground to debug:

lfd serve

Task hangs in auto mode

Symptom: Task starts but never completes.

The task may be waiting for input. Use interactive mode:

lf review -i    # interactive mode

Check if the coding agent is stuck on a permission prompt or clarifying question.

Rate limits

Symptom: Tasks fail with rate limit errors.

Claude, Codex, Gemini, and OpenCode have usage limits. Options:

Wait and retry
Reduce parallel waves
Switch to a different model: lf review -m codex

Worktree issues

Symptom: Git worktree commands fail or show stale data.

List all worktrees:

git worktree list

Clean up stale entries:

git worktree prune

Remove merged worktrees:

lf ops wt prune

Loop stuck in WAITING

Symptom: lfq list shows a wave in WAITING state.

The loop hit its PR limit. Options:

Review and merge outstanding PRs
Adjust the wave config in Concerto or via the Python API
Land accumulated work: see Waves for loop management

Context too large

Symptom: Task fails with context/token limit errors.

Reduce context:

lf review --no-lfdocs           # skip repo docs
lf review --no-diff-files       # skip branch files
lf review --area src/small/     # scope to specific area

Use summaries for large codebases:

lf ops summarize src/

See Configuration for context options.

Claude Code not found

Symptom: lf fails with “claude not found” or similar.

Run the setup wizard:

lf init

Check installation:

lf ops doctor

Loopflow