Skip to content

## biblio LLM backend: document Claude Max plan as primary use case The `biblio

biblio LLM backend: document Claude Max plan as primary use case

The biblio_extract and other LLM-dependent tools use claude -p (CLI print mode) as the default backend, which is correct for Claude Max plan users who don't want to burn API tokens. This is documented in llm.py but worth noting:

  1. The CLI backend is the right default for Max plan users
  2. --max-tokens was removed from the CLI call (not a valid CLI flag) — the CLI handles limits automatically
  3. The API fallback (BIBLIO_LLM_BACKEND=api) exists for CI/headless servers with API keys
  4. Consider documenting this in biblio README or biblio.yml config comments

Also: the _API_MODEL_MAP in llm.py should be kept up to date as new Claude models ship. Current mapping uses claude-sonnet-4-20250514 etc.