Gate Mode and Human Review#

Control how much the system pauses for your input with --gate.

--gate none (Default)#

Fully automatic. Runs end-to-end with no interaction. Summary cards are printed but the pipeline never pauses.

eurekaclaw prove "..." --gate none

--gate auto#

Summary cards after each stage. Pauses for human review only when a low-confidence lemma is detected (i.e., verified=false after the theory stage). Good for catching problems without constant interruption.

eurekaclaw prove "..." --gate auto

--gate human#

Pauses at every stage gate and asks for approval. After approving, you can type a correction or hint injected into the next agent’s prompt:

Approve theory stage? [y/n] y
Any feedback for the next stage? (Enter to skip): Use Bernstein instead of Hoeffding for lemma 3
eurekaclaw prove "..." --gate human

Note

Auto-escalation Even with --gate auto, if any lemma has verified=false, the gate automatically escalates to human review for that stage.

Theory Review Gate#

After the TheoryAgent completes and before the WriterAgent runs, EurekaClaw always shows a proof sketch review — regardless of --gate mode:

──────────────── Proof Sketch Review ────────────────
  L1  [✓] arm_pull_count_bound  verified
       For arm a with mean gap Δ_a ...
  L2  [~] regret_decomposition  low confidence
       Total regret decomposes as ...
  L3  [✓] main_theorem          verified
       UCB1 achieves O(√(KT log T)) regret ...
──────────────────────────────────────────────────────

Does this proof sketch look correct?
  y  — Proceed to writing
  n  — Flag the most logically problematic step
→
  • y / Enter — proceed to the WriterAgent

  • n — you specify which step has the critical gap (e.g. L2) and describe the issue. TheoryAgent re-runs once with your feedback injected.

Pause and Resume#

Pause a running session at the next stage boundary:

# In a separate terminal:
eurekaclaw pause <session_id>

# Or press Ctrl+C during the run — EurekaClaw saves a checkpoint instead of crashing

Resume from the checkpoint:

eurekaclaw resume <session_id>

The checkpoint is saved to ~/.eurekaclaw/sessions/<session_id>/checkpoint.json.