← Docs hub

AGENT / CLI MODE — synchronous claude -p synthesis.

Claude CLI synthesis backend

v1.4.0 uses synthesis.backend: claude for agent-friendly synthesis. Each page is synthesized with a single claude -p - invocation — no pending-prompt files, no --list-pending / --complete round-trip.

One-line enable

{
  "synthesis": {
    "backend": "claude",
    "claude_model": "sonnet"
  }
}

Optional: claude_path (binary path), timeout (seconds, default 180).

How it works

1. llmwiki synth (or add / all) resolves the backend.
2. For each new/changed raw file, the pipeline renders the source-page prompt.
3. ClaudeCLISynthesizer shells out to claude -p - with the prompt on stdin.
4. The wiki page is written immediately under wiki/sources/.

CLI

python3 -m llmwiki synth --check      # is claude available?
python3 -m llmwiki synth --estimate   # cost preview
python3 -m llmwiki synth              # run (sources + candidates)
python3 -m llmwiki synth --force      # re-synth everything

Removed (v1.4.0)

See UPGRADING.md for the one-time state migration.

Invariants

• Works with or without ANTHROPIC_API_KEY (uses the Claude Code CLI subscription when available).
• One backend serves sync auto-paths, synthesize, add, and all.
• Unavailable backend aborts the run (no silent dummy overwrite of real pages).