Configuration Reference

Edit ~/.claude/skills/h3/config.json (or %USERPROFILE%\.claude\skills\h3\config.json on Windows):

{
  "model": "deepseek/deepseek-v4-pro",
  "free_model": "nvidia/nemotron-3-nano-30b-a3b:free",
  "council_models": {
    "correctness": "openai/gpt-5.5",
    "performance": "google/gemini-3.1-pro-preview",
    "security": "x-ai/grok-4.20-beta"
  },
  "reasoning": "high",
  "docs_folder": "documents",
  "max_context": 200000,
  "enable_web_search": true
}

Options

Option	Description	Default
model	Model for single-model review	deepseek/deepseek-v4-pro
free_model	Model for --free flag	nvidia/nemotron-3-nano-30b-a3b:free
council_models	Models for council mode (see below)	GPT 5.5, Gemini 3.1 Pro, Grok 4.2
reasoning	Reasoning level (always high for code review)	high
docs_folder	Where your project documentation lives	documents
max_context	Token limit for reviews	200000
enable_web_search	Enable web search for reviews	true

---

Web Search (Enabled by Default)

Web search is enabled by default. This adds the :online suffix and Exa search plugin to API calls, allowing models to reference up-to-date documentation, CVEs, and best practices.

To disable, set "enable_web_search": false in config.json.

Notes:

• Web search adds ~$0.005 per request (Exa pricing)
• Free models (:free suffix) do not support web search

---

Council Models

Customize which models are used for each council role:

{
  "council_models": {
    "correctness": "openai/gpt-5.5",
    "performance": "google/gemini-3.1-pro-preview",
    "security": "x-ai/grok-4.20-beta"
  }
}

Role	Default Model	Focus Area
correctness	openai/gpt-5.5	Bugs, logic errors, edge cases, type safety
performance	google/gemini-3.1-pro-preview	N+1 queries, memory leaks, scaling issues
security	x-ai/grok-4.20-beta	Vulnerabilities, auth, injection, data exposure

Notes:

• You can override individual roles (unspecified roles use defaults)
• The same models are used for both code and plan reviews (with different prompts)
• Web search (:online suffix) is automatically added when enable_web_search: true

Example: Use Claude for correctness:

{
  "council_models": {
    "correctness": "anthropic/claude-sonnet-4"
  }
}

---

Context Limits

Mode	Limit	Rationale
All modes	200K tokens	GPT 5.5 (200K), Gemini 3.1 Pro (1M), Grok 4 (256K), DeepSeek V4 Pro (1M) - 200K matches GPT 5.5's window without hitting its surcharge tier

The context limit includes: diff + full file contents + documentation + test files. For very large PRs, the skill automatically breaks them into module-by-module reviews.

---

Available Models (via OpenRouter)

Mode	Model	Config Value	Price	Notes
Single	DeepSeek V4 Pro	deepseek/deepseek-v4-pro	~$0.435/$0.87 per 1M	DEFAULT - Strong reasoning at low cost
Free	Nemotron Nano	nvidia/nemotron-3-nano-30b-a3b:free	$0.00	Rotating free model
Council	3-Model Council	See council_models	~$9.00/$48 per 1M	GPT 5.5 + Gemini 3.1 Pro + Grok 4.2

The full council.py is in the public repo at scripts/council.py. You can read, audit, and modify it - it's MIT licensed. Council models are configurable via council_models in config.json.

---

Free Models

Free tiers rotate on OpenRouter. Use the included utility to find current free models:

python ~/.claude/skills/h3/scripts/list-free-models.py

# Example output:
# FREE MODELS ON OPENROUTER (newest first)
# ------------------------------------------------------------
#  1. nvidia/nemotron-3-nano-30b-a3b:free                             2025-12-09
#  2. deepseek/deepseek-r1:free          [THINKING]            2025-01-20
#  3. google/gemini-2.0-flash:free       [THINKING]            2025-01-10

Or browse manually: openrouter.ai/models

Free Tier Limits (OpenRouter)

Account Status	Daily Limit	Rate Limit
New/Low-credit	50 requests/day	20 RPM
$10+ credits added	1000 requests/day	20 RPM

Notes:

• Adding $10+ credits unlocks higher limits but keeps free model access
• Some free models may have stricter limits
• Heavy usage can trigger rate limiting

---

Cost Comparison

For a typical small code review (~10K chars / ~2.5K tokens input):

Mode	Estimated Cost	Quality
Single (DeepSeek V4 Pro)	~$0.005	Excellent
Free	$0.00	Very good
Council (3-Model)	~$0.14	Best (multi-perspective)

For a larger review (~50K chars / ~12.5K tokens input): Single ~$0.008, Council ~$0.23

Default is Single (DeepSeek V4 Pro) for strong reasoning at very low cost. Use --free for zero cost, or --council for multi-model consensus.