docs: document GRAPHIFY_CLAUDE_CLI_MODEL in the env-var table - #2893
docs: document GRAPHIFY_CLAUDE_CLI_MODEL in the env-var table#2893chintondutta wants to merge 1 commit into
Conversation
claude-cli defaults to Opus, which is overkill for structured extraction and community labeling; the env var to override it existed in code but wasn't documented anywhere a user would find it before spending Opus quota on a job haiku handles fine (Graphify-Labs#2861).
![graphify-labs[bot]](https://avatars.githubusercontent.com/in/4356270?s=60&v=4){kind=small}
There was a problem hiding this comment.
Graphify reviewed this change.
Looks safe to merge — no coupling regressions and no blocking issues, checked against the code graph (not a self-assessment).
Graphify review — findings
Documents the GRAPHIFY_CLAUDE_CLI_MODEL env var in the README's environment-variables table and common-commands section, noting it maps to claude -p --model and that haiku suffices for label/cluster-only (the claude-cli backend otherwise defaults to Opus).
No blocking issues surfaced.
Analysis details — impact, health, verification
Impact & health
Graphify review
Impact — 26 functions depend on the 26 functions this change touches.
Health — grade A; no new coupling hotspots.
Verification — 26 functions in the blast radius were not formally verified this run (proofs are advisory here).
Gate & verification
graphify gate
PASS — objectively clean (no health regressions, tests not run — proofs not run this pass (advisory)). Grounded, not self-assessed.
Advisory (not blocking):
- verification_scope: 26 function(s) in the blast radius were not formally verified this run
1 participant
Fixes #2861 (ask 1; a usage example is included too). Not included: ask 2 (surfacing it in
--help) and ask 3 (changing the default model for labeling) are behavior changes, left for a separate PR.The gap
GRAPHIFY_CLAUDE_CLI_MODELis read by theclaude-clibackend (graphify/llm.py:1571) but wasn't documented anywhere. Sinceclaude-clidefaults to Opus when the variable is unset, following the README as-is for--backend claude-clisilently spends Opus quota on jobs (like community naming viacluster-only) that a cheaper model handles fine.Change
ANTHROPIC_MODEL, noting the default (Opus) and thathaiku/sonnetare usually enough, especially forgraphify label/cluster-only.claude-cliexample, showingGRAPHIFY_CLAUDE_CLI_MODEL=haikuon acluster-onlyrun — the exact scenario from the issue report.Docs only, no code changes.