Repository navigation
Add 'xhigh' to VALID_EFFORT_LEVELS (Opus 4.7 effort value) #81
Description
Summary
askcc/settings.py defines VALID_EFFORT_LEVELS as {low, medium, high, max}, which is missing the xhigh level introduced with Claude Opus 4.7. Setting ASKCC_CLAUDE_EFFORT_LEVEL=xhigh currently triggers the invalid-value warning and falls back to the default.
Anthropic's authoritative list (docs):
| Value | Availability |
|---|---|
low |
all supported models |
medium |
all supported models |
high |
all supported models (API default) |
xhigh |
Opus 4.7 only — missing from askcc-cli |
max |
Mythos Preview, Opus 4.7, Opus 4.6, Sonnet 4.6 |
Per the docs, xhigh is the recommended starting point for coding and agentic work on Opus 4.7, so askcc-cli should both support it and default to it.
Proposed Approach
In askcc/settings.py:
- Add
XHIGH = "xhigh"to theVALID_EFFORT_LEVELSenum betweenHIGHandMAX. - Change
DEFAULT_EFFORT_LEVELfromVALID_EFFORT_LEVELS.MAXtoVALID_EFFORT_LEVELS.XHIGH— aligns askcc-cli's default with Anthropic's recommended starting point for coding/agentic work on Opus 4.7 and avoids the "overthinking" / high-cost profile ofmaxon structured tasks. - Verify
_resolve_effort_level()warning message still renders the full list correctly (it iterates the enum, so no code change needed there). - Update any docs/README references to the supported effort levels and the new default.
Acceptance Criteria
-
VALID_EFFORT_LEVELSenum includesXHIGH = "xhigh". -
DEFAULT_EFFORT_LEVELresolves toVALID_EFFORT_LEVELS.XHIGHwhenASKCC_CLAUDE_EFFORT_LEVELis unset. -
ASKCC_CLAUDE_EFFORT_LEVEL=xhighresolves without the "Invalid ASKCC_CLAUDE_EFFORT_LEVEL" warning. - Unit test covers the new value and the new default.
- README / env-var documentation lists
xhighas a valid value and reflects the new default.
References
- Anthropic effort parameter docs: https://platform.claude.com/docs/en/build-with-claude/effort
- Comment-add commit that surfaced the enum: 41fe723
Activity
Merge pull request #82 from monkut/feature/81-add-xhigh-effort-level
monkut commentedon Apr 25, 2026
Confirmed satisfied by #82 (merged). Verified against current
main:askcc/settings.py:43—XHIGH = "xhigh"added betweenHIGHandMAX.askcc/settings.py:47—DEFAULT_EFFORT_LEVEL = VALID_EFFORT_LEVELS.XHIGH._resolve_effort_level()iterates the enum, soxhighno longer triggers the invalid-value warning.tests/test_askcc.py:1586—test_xhigh_effort_level_resolves_without_warning.tests/test_askcc.py:1595—test_default_effort_level_is_xhigh.Closing.