@@ -353,7 +353,7 @@ I.decideVisually('sidebar is shown')
 
 It uses a [decision model](https://openrouter.ai/models?output_modalities=decisions) like [Jev](https://openrouter.ai/typesafe/jev-1.13) instead of a chat model. A decision model reads the page and returns the probability that a statement is true. It is fast, costs a fraction of a cent per request, and gives a probability instead of free text, so a step passes or fails on a confidence threshold you set.
 
-The Decision helper calls the decisions API directly and does not use the `ai` config section or the `--ai` flag. See [Decision Assertions](/assertions#decision-assertions) for setup and usage.
+Configure it in `ai.decisionModel`. Decisions call the decisions API directly, so they don't need `ai.model` or the `--ai` flag. See [Decision Assertions](/assertions#decision-assertions) for setup and usage.
 
 ## Advanced Configuration
 
 
@@ -407,18 +407,35 @@ A [decision model](https://openrouter.ai/models?output_modalities=decisions), li
 - **Cost-efficient.** A request costs a fraction of a cent. You can run decision assertions in every CI build.
 - **Reliable.** The answer is a probability, not free text. There is nothing to parse, and you choose how confident the model must be for the step to pass.
 
-Enable the helper next to your browser helper and set `OPENROUTER_API_KEY`:
+Set `OPENROUTER_API_KEY`, configure the decision model in the `ai` section, and enable the helper next to your browser helper:
 
 ```js
-helpers: {
-  Playwright: { url: 'http://localhost' },
-  Decision: {
+ai: {
+  decisionModel: {
     model: 'typesafe/jev-1.13',
     confidence: 0.7,
   },
+},
+helpers: {
+  Playwright: { url: 'http://localhost' },
+  Decision: {},
 }
 ```
 
+`ai.decisionModel` accepts:
+
+| Option | Default | Description |
+|---|---|---|
+| `provider` | `openrouter` | `openrouter` reads `OPENROUTER_API_KEY`, `typesafe` reads `TYPESAFE_API_KEY` |
+| `apiKey` | | API key, overrides the environment variable |
+| `model` | `typesafe/jev-1.13` | model for `I.decide` |
+| `visualModel` | `cloudflare/clef` | model with image input for `I.decideVisually`, OpenRouter only |
+| `confidence` | `0.7` | minimal probability for a statement to pass |
+| `timeout` | `15000` | request timeout in ms |
+| `maxLength` | `12000` | maximal length of ARIA snapshot or HTML sent to the model |
+
+Decisions don't need the `--ai` flag, and `ai.model` is not required.
+
 Then assert statements about the current page:
 
 ```js
 
@@ -59,7 +59,7 @@ class AiAssistant {
     debug('Enabling AI assistant')
     this.isEnabled = true
 
-    const { html, prompts, ...aiConfig } = config
+    const { html, prompts, decisionModel, ...aiConfig } = config
 
     this.config = Object.assign(this.config, aiConfig)
     this.htmlConfig = Object.assign(defaultHtmlConfig, html)
@@ -276,37 +276,60 @@ const DECISION_ENDPOINTS = {
   typesafe: { url: 'https://api.typesafe.ai/v1/systemone', keyName: 'TYPESAFE_API_KEY' },
 }
 
+const defaultDecisionConfig = {
+  provider: 'openrouter',
+  model: 'typesafe/jev-1.13',
+  visualModel: 'cloudflare/clef',
+  confidence: 0.7,
+  timeout: 15000,
+  maxLength: 12000,
+}
+
 class DecisionConnectionError extends Error {}
 
 class DecisionAI {
-  constructor({ provider = 'openrouter', apiKey, timeout = 15000 } = {}) {
+  constructor(config = {}) {
+    this.config = { ...defaultDecisionConfig, ...config }
+
+    const { provider, confidence } = this.config
     this.endpoint = DECISION_ENDPOINTS[provider]
-    if (!this.endpoint) throw new Error(`Unknown decision provider "${provider}", use one of: ${Object.keys(DECISION_ENDPOINTS).join(', ')}`)
-    this.provider = provider
-    this.apiKey = apiKey
-    this.timeout = timeout
+    if (!this.endpoint) throw new Error(`Unknown decision provider "${provider}" in ai.decisionModel, use one of: ${Object.keys(DECISION_ENDPOINTS).join(', ')}`)
+    if (!(confidence > 0 && confidence < 1)) throw new Error(`ai.decisionModel.confidence must be between 0 and 1, got ${confidence}`)
+
     this.fetchImpl = fetch
   }
 
   checkModel() {
-    if (this.apiKey || process.env[this.endpoint.keyName]) return
+    if (this.config.apiKey || process.env[this.endpoint.keyName]) return
 
     const noKeyErrorMessage = `
      No API key is set for decision model.
 
-     [!] Set ${this.endpoint.keyName} environment variable or pass apiKey in config.
+     [!] Set ${this.endpoint.keyName} environment variable or apiKey in ai.decisionModel config.
 
      Example (connect to OpenRouter, default):
 
      export OPENROUTER_API_KEY=sk-or-...
 
+     ai: {
+       decisionModel: {
+         model: 'typesafe/jev-1.13',
+         confidence: 0.7,
+       }
+     }
+
      Get a key at https://openrouter.ai/settings/keys
 
      Example (connect to TypeSafe):
 
      export TYPESAFE_API_KEY=...
 
-     { provider: 'typesafe', model: 'jev-latest' }
+     ai: {
+       decisionModel: {
+         provider: 'typesafe',
+         model: 'jev-latest',
+       }
+     }
 
      See https://openrouter.ai/models?output_modalities=decisions for all decision models.
     `.trim()
@@ -317,12 +340,12 @@ class DecisionAI {
   async decide(model, state, statements) {
     this.checkModel()
 
-    const apiKey = this.apiKey || process.env[this.endpoint.keyName]
+    const apiKey = this.config.apiKey || process.env[this.endpoint.keyName]
     const questions = Object.fromEntries(statements.map((statement, i) => [`q${i}`, { type: 'noul', instructions: statement }]))
     debug('Decision request', model, statements)
 
     const controller = new AbortController()
-    const timer = setTimeout(() => controller.abort(), this.timeout)
+    const timer = setTimeout(() => controller.abort(), this.config.timeout)
 
     let response
     try {
@@ -333,7 +356,7 @@ class DecisionAI {
         signal: controller.signal,
       })
     } catch (err) {
-      if (controller.signal.aborted) throw new DecisionConnectionError(`Decision model ${model} did not respond in ${this.timeout}ms`)
+      if (controller.signal.aborted) throw new DecisionConnectionError(`Decision model ${model} did not respond in ${this.config.timeout}ms`)
       throw new DecisionConnectionError(`Decision model ${model} request failed: ${err.message}`)
     } finally {
       clearTimeout(timer)
 
@@ -3,22 +3,14 @@ import path from 'path'
 
 import Helper from '@codeceptjs/helper'
 import Container from '../container.js'
+import Config from '../config.js'
 import store from '../store.js'
 import AssertionFailedError from '../assert/error.js'
 import { compactAriaSnapshot } from '../aria.js'
 import { minifyHtml } from '../html.js'
 import { pickActingHelper } from '../utils/trace.js'
 import { DecisionAI, DecisionConnectionError } from '../ai.js'
 
-const defaultConfig = {
-  provider: 'openrouter',
-  model: 'typesafe/jev-1.13',
-  visualModel: 'cloudflare/clef',
-  confidence: 0.7,
-  timeout: 15000,
-  maxLength: 12000,
-}
-
 /**
  * Asserts statements about the current page with a decision model.
  *
@@ -45,15 +37,21 @@ const defaultConfig = {
  *
  * ## Configuration
  *
+ * Decision model is configured in the `ai.decisionModel` section of the config.
+ * The helper itself has no options:
+ *
  * ```js
- * helpers: {
- *   Playwright: { url: 'http://localhost', browser: 'chromium' },
- *   Decision: {
+ * ai: {
+ *   decisionModel: {
  *     provider: 'openrouter',
  *     model: 'typesafe/jev-1.13',
  *     visualModel: 'cloudflare/clef',
  *     confidence: 0.7,
  *   },
+ * },
+ * helpers: {
+ *   Playwright: { url: 'http://localhost', browser: 'chromium' },
+ *   Decision: {},
  * }
  * ```
  *
@@ -65,26 +63,16 @@ const defaultConfig = {
  * * `timeout` (default: `15000`) - request timeout in ms.
  * * `maxLength` (default: `12000`) - maximal length of ARIA snapshot or HTML sent to the model.
  *
+ * Decisions work without the `--ai` flag.
  * Browse all decision models at [OpenRouter](https://openrouter.ai/models?output_modalities=decisions).
  *
  * ## Methods
  */
 class Decision extends Helper {
   constructor(config = {}) {
     super(config)
-    this.options = { ...defaultConfig, ...config }
-
-    const { confidence } = this.options
-    if (!(confidence > 0 && confidence < 1)) throw new Error(`Decision confidence must be between 0 and 1, got ${confidence}`)
-
-    this.decisionAI = new DecisionAI(this.options)
-  }
-
-  static _config() {
-    return [
-      { name: 'provider', message: 'Decision API provider (openrouter, typesafe)', default: defaultConfig.provider },
-      { name: 'model', message: 'Decision model', default: defaultConfig.model },
-    ]
+    this.decisionAI = new DecisionAI(Config.get('ai', {}).decisionModel)
+    this.options = this.decisionAI.config
   }
 
   /**
 
@@ -4,6 +4,12 @@ import os from 'os'
 import path from 'path'
 import Decision from '../../../lib/helper/Decision.js'
 import store from '../../../lib/store.js'
+import Config from '../../../lib/config.js'
+
+function createDecision(decisionModel) {
+  Config.create({ ai: { decisionModel } })
+  return new Decision({})
+}
 
 function fakeFetch(answers, calls, status = 200) {
   return async (url, options) => {
@@ -32,9 +38,11 @@ describe('Decision helper', () => {
   let decision
   let calls
 
+  afterEach(() => Config.reset())
+
   beforeEach(() => {
     calls = []
-    decision = new Decision({ apiKey: 'secret' })
+    decision = createDecision({ apiKey: 'secret' })
     decision._actingHelper = () => browser
   })
 
@@ -63,7 +71,7 @@ describe('Decision helper', () => {
   })
 
   it('respects configured confidence', async () => {
-    decision = new Decision({ apiKey: 'secret', confidence: 0.95 })
+    decision = createDecision({ apiKey: 'secret', confidence: 0.95 })
     decision._actingHelper = () => browser
     decision.decisionAI.fetchImpl = fakeFetch(noul(0.9), calls)
 
@@ -120,7 +128,7 @@ describe('Decision helper', () => {
   })
 
   it('uses typesafe endpoint', async () => {
-    decision = new Decision({ apiKey: 'secret', provider: 'typesafe', model: 'jev-latest' })
+    decision = createDecision({ apiKey: 'secret', provider: 'typesafe', model: 'jev-latest' })
     decision._actingHelper = () => browser
     decision.decisionAI.fetchImpl = fakeFetch(noul(0.9), calls)
     await decision.decide('page is loaded')
@@ -142,7 +150,7 @@ describe('Decision helper', () => {
   })
 
   it('times out hanging requests', async () => {
-    decision = new Decision({ apiKey: 'secret', timeout: 50 })
+    decision = createDecision({ apiKey: 'secret', timeout: 50 })
     decision._actingHelper = () => browser
     decision.decisionAI.fetchImpl = (url, { signal }) => new Promise((_, reject) => signal.addEventListener('abort', () => reject(new Error('aborted'))))
 
@@ -179,16 +187,23 @@ describe('Decision helper', () => {
     expect(err.isTerminal).to.be.undefined
   })
 
+  it('reads config from ai.decisionModel', () => {
+    decision = createDecision({ apiKey: 'secret', model: 'jev-latest', confidence: 0.9 })
+    expect(decision.options.model).to.equal('jev-latest')
+    expect(decision.options.confidence).to.equal(0.9)
+    expect(decision.options.visualModel).to.equal('cloudflare/clef')
+  })
+
   it('validates config', () => {
-    expect(() => new Decision({ apiKey: 'secret', provider: 'unknown' })).to.throw('Unknown decision provider')
-    expect(() => new Decision({ apiKey: 'secret', confidence: 1.5 })).to.throw('between 0 and 1')
+    expect(() => createDecision({ apiKey: 'secret', provider: 'unknown' })).to.throw('Unknown decision provider')
+    expect(() => createDecision({ apiKey: 'secret', confidence: 1.5 })).to.throw('between 0 and 1')
   })
 
   it('requires api key only when deciding', async () => {
     const key = process.env.TYPESAFE_API_KEY
     delete process.env.TYPESAFE_API_KEY
     try {
-      decision = new Decision({ provider: 'typesafe' })
+      decision = createDecision({ provider: 'typesafe' })
       decision._actingHelper = () => browser
       decision.decisionAI.fetchImpl = fakeFetch(noul(0.9), calls)