explorbot 0.5.7 → 0.5.8

package/bin/explorbot-cli.ts

@@ -502,6 +502,7 @@ program
   .option('-g, --global', 'Configure explorbot in ~/.explorbot to run from anywhere')
   .option('--provider <name>', `AI provider for the global config: ${Object.keys(PROVIDERS).join(', ')}`)
   .option('--api-key <key>', 'API key stored in ~/.explorbot/.env')
+  .option('--url <url>', 'Web application URL written to web.url in the local config')
   .action(async (options) => {
     try {
       const { runInit } = await import('../src/commands/init-command.js');
@@ -512,6 +513,7 @@ program
         global: options.global,
         provider: options.provider,
         apiKey: options.apiKey,
+        url: options.url,
       });
     } catch (error) {
       console.error('Failed:', error instanceof Error ? error.message : 'Unknown error');

package/dist/bin/explorbot-cli.js

@@ -452,6 +452,7 @@ program
     .option('-g, --global', 'Configure explorbot in ~/.explorbot to run from anywhere')
     .option('--provider <name>', `AI provider for the global config: ${Object.keys(PROVIDERS).join(', ')}`)
     .option('--api-key <key>', 'API key stored in ~/.explorbot/.env')
+    .option('--url <url>', 'Web application URL written to web.url in the local config')
     .action(async (options) => {
     try {
         const { runInit } = await import('../src/commands/init-command.js');
@@ -462,6 +463,7 @@ program
             global: options.global,
             provider: options.provider,
             apiKey: options.apiKey,
+            url: options.url,
         });
     }
     catch (error) {

package/dist/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explorbot",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
   "license": "Elastic-2.0",
   "type": "module",

package/dist/src/commands/explore-command.js

@@ -576,6 +576,13 @@ export class ExploreCommand extends BaseCommand {
                 commands,
             });
         }
+        sections.push({
+            label: 'Explore more',
+            commands: [
+                { label: 'Whole site', command: `${cli} explore /` },
+                { label: 'Docs', command: 'https://testomat.ai/docs/explorbot' },
+            ],
+        });
         printNextSteps(sections);
     }
     isLimitReached() {

package/dist/src/commands/init-command.d.ts

@@ -11,5 +11,6 @@ type InitCommandOptions = {
     global?: boolean;
     provider?: string;
     apiKey?: string;
+    url?: string;
 };
 export {};

package/dist/src/commands/init-command.js

@@ -1,24 +1,29 @@
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { dirname, extname, join, resolve } from 'node:path';
 import chalk from 'chalk';
+import figureSet from 'figures';
 import { ConfigParser, PROVIDERS, missingModelRoles } from "../config.js";
 import { findGlobalConfig, globalConfigPath, globalDir, globalEnvPath } from "../global-config.js";
 import { getCliName } from "../utils/cli-name.js";
 import { log, tag } from '../utils/logger.js';
-import { relativeToCwd } from "../utils/next-steps.js";
-function defaultConfigTemplate(provider) {
+import { printNextSteps, relativeToCwd } from "../utils/next-steps.js";
+function defaultConfigTemplate(provider, url) {
+    const appUrl = url || 'http://<your-app-host-here>';
     return `// 'provider/model-id' uses a bundled provider.
 // It is also possible to import provider as a module from Vercel AI SDK.
-// https://github.com/testomatio/explorbot/blob/main/docs/basics/providers.md
+// https://testomat.ai/docs/explorbot
 
 const config = {
   web: {
     // use application host without path prefix (e.g., http://localhost:3000)
-    url: 'http://<your-app-host-here>',
+    url: '${appUrl}',
   },
 
   ai: {
-${modelLines(provider)}
+    // every role (model, visionModel, agenticModel) takes the recommended ${provider} models bundled with this version
+    // override a single role as 'provider/model-id':
+    // model: '${provider}/<model-id>',
+    recommendedModels: '${provider}',
   },
 
   reporter: {
@@ -35,9 +40,10 @@ export default config;
 `;
 }
 export function envTemplate(provider) {
+    const { keyUrl } = PROVIDERS[provider];
     const keyLines = Object.entries(PROVIDERS).map(([name, { envKey }]) => {
         if (name === provider)
-            return `${envKey}=`;
+            return `# Create a key at ${keyUrl} and paste it after '='\n${envKey}=`;
         return `# ${envKey}=`;
     });
     return `# AI provider API keys
@@ -64,10 +70,10 @@ export async function runInit(options) {
     const choice = await renderInitWizard('choose');
     if (choice !== 'local')
         return;
-    const provider = await renderLocalProviderWizard();
-    if (!provider)
+    const setup = await renderLocalSetupWizard();
+    if (!setup)
         return;
-    runInitCommand({ ...options, provider });
+    runInitCommand({ ...options, ...setup });
 }
 export function writeGlobalConfig(provider, apiKey) {
     if (!PROVIDERS[provider]) {
@@ -75,21 +81,25 @@ export function writeGlobalConfig(provider, apiKey) {
     }
     mkdirSync(globalDir(), { recursive: true });
     writeFileSync(globalConfigPath(), globalConfigTemplate(provider), 'utf8');
-    log(`Created global config: ${globalConfigPath()}`);
+    tag('success').log(`${figureSet.tick} Created global config: ${globalConfigPath()}`);
     const envKey = PROVIDERS[provider].envKey;
     writeEnvKey(envKey, apiKey || '');
-    log(`Stored ${envKey} in ${globalEnvPath()}`);
+    tag('success').log(`${figureSet.tick} Stored ${envKey} in ${globalEnvPath()}`);
     const missing = missingModelRoles(provider);
     if (missing.length) {
         tag('warning').log(`No recommended ${missing.join(' and ')} for ${provider} — set the model ids in ${globalConfigPath()}`);
     }
     if (!apiKey && !process.env[envKey]) {
-        tag('warning').log(`Add your API key to ${globalEnvPath()}`);
+        printApiKeySteps(provider, globalEnvPath());
     }
     log('');
-    log('Explorbot now runs from any directory:');
-    tag('substep').log(chalk.yellow(`${getCliName()} explore https://your-app.example.com`));
-    tag('substep').log(chalk.yellow(`${getCliName()} sites`));
+    log(`${figureSet.star} What's next:`);
+    printInitNextSteps({
+        siteCommands: [
+            { label: 'Any site', command: `${getCliName()} explore https://your-app.example.com` },
+            { label: 'Saved sites', command: `${getCliName()} sites` },
+        ],
+    });
 }
 export function runInitCommand(options) {
     const provider = options.provider || 'openrouter';
@@ -125,34 +135,38 @@ export function runInitCommand(options) {
             log('Use --force to overwrite existing file');
             process.exit(1);
         }
-        writeFileSync(outPath, defaultConfigTemplate(provider), 'utf8');
-        log(`Created config file: ${relativeToCwd(outPath)}`);
+        writeFileSync(outPath, defaultConfigTemplate(provider, options.url), 'utf8');
+        tag('success').log(`${figureSet.tick} Created config file: ${relativeToCwd(outPath)}`);
         const envPath = resolve(process.cwd(), '.env');
         if (!existsSync(envPath)) {
             writeFileSync(envPath, `${envTemplate(provider)}\n`, 'utf8');
-            log(`Created env file: ${relativeToCwd(envPath)}`);
+            tag('success').log(`${figureSet.tick} Created env file: ${relativeToCwd(envPath)}`);
         }
         else {
             log(`Env file already exists: ${relativeToCwd(envPath)}`);
         }
+        const envKey = PROVIDERS[provider].envKey;
+        if (options.apiKey) {
+            writeEnvKey(envKey, options.apiKey, envPath);
+            tag('success').log(`${figureSet.tick} Stored ${envKey} in ${relativeToCwd(envPath)}`);
+        }
+        if (!options.apiKey && !process.env[envKey]) {
+            printApiKeySteps(provider, relativeToCwd(envPath));
+        }
+        if (!options.url) {
+            tag('warning').log(`Set your application URL in web.url: ${relativeToCwd(outPath)}`);
+        }
         const missing = missingModelRoles(provider);
         if (missing.length) {
             tag('warning').log(`No recommended ${missing.join(' and ')} for ${provider} — set the model ids in ${relativeToCwd(outPath)}`);
         }
-        log('');
-        log('Next steps:');
-        log('1. Configure AI provider in .env');
-        log('2. Set AI models config file');
-        log('3. Set web application URL in the config file');
-        log('4. Add initial knowledge (how to authorize to the application, etc.)');
-        tag('substep').log(chalk.yellow(`${getCliName()} learn '*' 'to authorize use these credentials: admin@example.com / secret123'`));
-        tag('substep').log('You can use ${env.LOGIN} and ${env.PASSWORD} to reference environment variables.');
-        log('5. Launch application on a relative URL');
-        tag('substep').log(chalk.yellow(`${getCliName()} start /dashboard`));
         if (!existsSync('./output')) {
             mkdirSync('./output', { recursive: true });
-            log('Created directory: output');
+            tag('success').log(`${figureSet.tick} Created directory: output`);
         }
+        log('');
+        log(`${figureSet.star} What's next:`);
+        printInitNextSteps({ url: options.url });
     }
     catch (error) {
         log('Failed to create config file:', error);
@@ -198,12 +212,12 @@ async function renderInitWizard(mode) {
         }), { exitOnCtrlC: false, patchConsole: false });
     });
 }
-async function renderLocalProviderWizard() {
+async function renderLocalSetupWizard() {
     const [{ render }, React, InitWizard] = await Promise.all([import('ink'), import('react'), import('../components/InitWizard.js').then((m) => m.default)]);
     return new Promise((resolve) => {
-        const finish = (provider) => {
+        const finish = (setup) => {
             unmount();
-            resolve(provider);
+            resolve(setup);
         };
         const { unmount } = render(React.createElement(InitWizard, {
             mode: 'local',
@@ -211,7 +225,7 @@ async function renderLocalProviderWizard() {
             onLocal: () => finish(null),
             onComplete: () => finish(null),
             onCancel: () => finish(null),
-            onLocalProvider: (provider) => finish(provider),
+            onLocalSetup: (setup) => finish(setup),
         }), { exitOnCtrlC: false, patchConsole: false });
     });
 }
@@ -238,7 +252,7 @@ function globalConfigTemplate(provider) {
 // Models are written as 'provider/model-id' so they resolve without a local node_modules.
 // The key is read from ${envKey} in ~/.explorbot/.env
 // Model ids are snapshotted from the recommendations of this Explorbot version.
-// https://github.com/testomatio/explorbot/blob/main/docs/basics/providers.md
+// https://testomat.ai/docs/explorbot
 const config = {
   ai: {
 ${modelLines(provider)}
@@ -255,8 +269,39 @@ ${modelLines(provider)}
 export default config;
 `;
 }
-function writeEnvKey(key, value) {
-    const envPath = globalEnvPath();
+function printInitNextSteps(options) {
+    const cli = getCliName();
+    const sections = [
+        {
+            label: 'Try the demo on a sample app',
+            commands: [{ command: `${cli} explore https://todomvc.com/examples/react/dist/` }],
+        },
+    ];
+    if (options.url) {
+        sections.push({
+            label: 'Explore your app',
+            commands: [
+                { label: 'Whole site', command: `${cli} explore ${options.url}` },
+                { label: 'One page', command: `${cli} explore /dashboard` },
+            ],
+        });
+    }
+    if (options.siteCommands)
+        sections.push({ label: 'Explore any site', commands: options.siteCommands });
+    sections.push({
+        label: 'Run it from VS Code',
+        commands: [{ command: 'https://testomat.ai/explorbot' }],
+    }, {
+        label: 'Docs',
+        commands: [{ command: 'https://testomat.ai/docs/explorbot' }],
+    });
+    printNextSteps(sections);
+    log('');
+    log('Add knowledge (logins, credentials) — created on first use in ./knowledge:');
+    tag('substep').log(chalk.yellow(`${cli} learn '*' 'to authorize use these credentials: admin@example.com / secret123'`));
+    tag('substep').log('You can use ${env.LOGIN} and ${env.PASSWORD} to reference environment variables.');
+}
+function writeEnvKey(key, value, envPath = globalEnvPath()) {
     let content = '# AI provider API keys';
     if (existsSync(envPath))
         content = readFileSync(envPath, 'utf8').trimEnd();
@@ -268,3 +313,9 @@ function writeEnvKey(key, value) {
         lines[index] = `${key}=${value}`;
     writeFileSync(envPath, `${lines.join('\n').trimEnd()}\n`, 'utf8');
 }
+function printApiKeySteps(provider, envPath) {
+    const { envKey, keyUrl } = PROVIDERS[provider];
+    tag('warning').log(`No API key yet — explorbot needs one to connect to ${provider}`);
+    tag('substep').log(`1. Create a key at ${keyUrl}`);
+    tag('substep').log(`2. Paste it into ${envPath}: ${envKey}=<your-key>`);
+}

package/dist/src/components/InitWizard.d.ts

@@ -5,7 +5,11 @@ interface InitWizardProps {
     onLocal: () => void;
     onComplete: () => void;
     onCancel: () => void;
-    onLocalProvider?: (provider: string) => void;
+    onLocalSetup?: (setup: {
+        provider: string;
+        apiKey: string;
+        url: string;
+    }) => void;
 }
 declare const InitWizard: React.FC<InitWizardProps>;
 export default InitWizard;

package/dist/src/components/InitWizard.js

@@ -7,16 +7,23 @@ import { ConfigParser, PROVIDERS, createModel } from '../config.js';
 import { globalDir } from '../global-config.js';
 import InputReadline from './InputReadline.js';
 const PROVIDER_NAMES = Object.keys(PROVIDERS);
-const InitWizard = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, onLocalProvider }) => {
+const InitWizard = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, onLocalSetup }) => {
     const [step, setStep] = useState(mode === 'choose' ? 'target' : 'provider');
     const [targetIndex, setTargetIndex] = useState(0);
     const [providerIndex, setProviderIndex] = useState(0);
     const [apiKey, setApiKey] = useState('');
+    const [url, setUrl] = useState('');
+    const [urlError, setUrlError] = useState('');
     const [status, setStatus] = useState('');
     const [error, setError] = useState('');
     const provider = PROVIDER_NAMES[providerIndex];
     const envKey = PROVIDERS[provider].envKey;
     const save = () => {
+        if (mode === 'local') {
+            setStatus('');
+            setStep('url');
+            return;
+        }
         writeGlobalConfig(provider, apiKey.trim());
         onComplete();
     };
@@ -45,7 +52,7 @@ const InitWizard = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, o
             onCancel();
             return;
         }
-        if (step === 'key')
+        if (step === 'key' || step === 'url')
             return;
         if (key.escape) {
             onCancel();
@@ -67,12 +74,8 @@ const InitWizard = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, o
                 setProviderIndex((index) => Math.max(0, index - 1));
             if (key.downArrow)
                 setProviderIndex((index) => Math.min(PROVIDER_NAMES.length - 1, index + 1));
-            if (key.return) {
-                if (mode === 'local')
-                    onLocalProvider?.(provider);
-                else
-                    setStep('key');
-            }
+            if (key.return)
+                setStep('key');
             return;
         }
         if (status)
@@ -109,10 +112,12 @@ const InitWizard = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, o
             React.createElement(Text, null,
                 "Enter the API key for ",
                 provider,
-                " ",
+                ' ',
                 React.createElement(Text, { dimColor: true },
                     "(stored as ",
                     envKey,
+                    ", create one at ",
+                    PROVIDERS[provider].keyUrl,
                     ")")),
             React.createElement(Box, { borderStyle: "single", borderColor: "blue", paddingX: 1 },
                 React.createElement(InputReadline, { value: apiKey, onChange: setApiKey, onSubmit: () => setStep('validate'), placeholder: process.env[envKey] ? 'leave empty to keep the key from your environment' : 'paste the key', isActive: true, showPrompt: false, mask: true })))),
@@ -121,13 +126,26 @@ const InitWizard = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, o
             status && React.createElement(Text, { color: "yellow" }, status),
             error && (React.createElement(Box, { flexDirection: "column" },
                 React.createElement(Text, { color: "red" }, error),
-                React.createElement(Text, { dimColor: true }, "r: re-enter the key | n: save anyway"))))),
+                React.createElement(Text, { dimColor: true }, "r: re-enter the key | n: continue anyway"))))),
+        step === 'url' && (React.createElement(Box, { flexDirection: "column" },
+            React.createElement(Text, null,
+                "What is the URL of the web application to test? ",
+                React.createElement(Text, { dimColor: true }, "(written to web.url in the config)")),
+            React.createElement(Box, { borderStyle: "single", borderColor: "blue", paddingX: 1 },
+                React.createElement(InputReadline, { value: url, onChange: setUrl, onSubmit: () => {
+                        if (!URL.canParse(url.trim())) {
+                            setUrlError('Enter a full URL, e.g. http://localhost:3000');
+                            return;
+                        }
+                        onLocalSetup?.({ provider, apiKey: apiKey.trim(), url: url.trim() });
+                    }, placeholder: "http://localhost:3000", isActive: true, showPrompt: false })),
+            urlError && React.createElement(Text, { color: "red" }, urlError))),
         React.createElement(Box, { marginTop: 1 },
             React.createElement(Text, { dimColor: true },
                 "Config goes to ",
                 mode === 'local' ? 'the current directory' : globalDir(),
                 " | ",
-                step === 'key' ? 'Enter: continue' : '↑↓: select | Enter: confirm',
+                step === 'key' || step === 'url' ? 'Enter: continue' : '↑↓: select | Enter: confirm',
                 " | Ctrl+C: exit"))));
 };
 function defaultModelId(provider) {

package/dist/src/config.d.ts

@@ -141,6 +141,7 @@ interface AgentsConfig {
 }
 interface AIConfig {
     model: any;
+    recommendedModels?: string;
     apiKey?: string;
     config?: Record<string, any>;
     langfuse?: {
@@ -315,6 +316,7 @@ interface ConfiguredModel {
 }
 interface ProviderInfo {
     envKey: string;
+    keyUrl: string;
     load: () => Promise<(modelId: string) => any>;
 }
 interface EnvVar {

package/dist/src/config.js

@@ -18,13 +18,13 @@ import { getCliName } from './utils/cli-name.js';
 import { deepMerge } from './utils/merge.js';
 import { log, tag } from './utils/logger.js';
 export const PROVIDERS = {
-    openai: { envKey: 'OPENAI_API_KEY', load: async () => (await import('@ai-sdk/openai')).createOpenAI() },
-    anthropic: { envKey: 'ANTHROPIC_API_KEY', load: async () => (await import('@ai-sdk/anthropic')).createAnthropic() },
-    google: { envKey: 'GOOGLE_GENERATIVE_AI_API_KEY', load: async () => (await import('@ai-sdk/google')).createGoogleGenerativeAI() },
-    groq: { envKey: 'GROQ_API_KEY', load: async () => (await import('@ai-sdk/groq')).createGroq() },
-    mistral: { envKey: 'MISTRAL_API_KEY', load: async () => (await import('@ai-sdk/mistral')).createMistral() },
-    openrouter: { envKey: 'OPENROUTER_API_KEY', load: async () => (await import('@openrouter/ai-sdk-provider')).createOpenRouter() },
-    sambanova: { envKey: 'SAMBANOVA_API_KEY', load: async () => (await import('sambanova-ai-provider')).createSambaNova() },
+    openai: { envKey: 'OPENAI_API_KEY', keyUrl: 'https://platform.openai.com/api-keys', load: async () => (await import('@ai-sdk/openai')).createOpenAI() },
+    anthropic: { envKey: 'ANTHROPIC_API_KEY', keyUrl: 'https://console.anthropic.com/settings/keys', load: async () => (await import('@ai-sdk/anthropic')).createAnthropic() },
+    google: { envKey: 'GOOGLE_GENERATIVE_AI_API_KEY', keyUrl: 'https://aistudio.google.com/apikey', load: async () => (await import('@ai-sdk/google')).createGoogleGenerativeAI() },
+    groq: { envKey: 'GROQ_API_KEY', keyUrl: 'https://console.groq.com/keys', load: async () => (await import('@ai-sdk/groq')).createGroq() },
+    mistral: { envKey: 'MISTRAL_API_KEY', keyUrl: 'https://console.mistral.ai/api-keys', load: async () => (await import('@ai-sdk/mistral')).createMistral() },
+    openrouter: { envKey: 'OPENROUTER_API_KEY', keyUrl: 'https://openrouter.ai/keys', load: async () => (await import('@openrouter/ai-sdk-provider')).createOpenRouter() },
+    sambanova: { envKey: 'SAMBANOVA_API_KEY', keyUrl: 'https://cloud.sambanova.ai/apis', load: async () => (await import('sambanova-ai-provider')).createSambaNova() },
 };
 export const MODEL_ROLES = ['model', 'visionModel', 'agenticModel'];
 let cachedOutputRoot = null;
@@ -572,11 +572,33 @@ export async function resolveConfigModels(ai) {
         if (typeof ai[role] === 'string')
             ai[role] = await resolveModel(ai[role], role);
     }
+    await fillRecommendedModels(ai);
     for (const agent of Object.values(ai.agents || {})) {
         if (typeof agent?.model === 'string')
             agent.model = await resolveModel(agent.model);
     }
 }
+async function fillRecommendedModels(ai) {
+    const provider = ai.recommendedModels;
+    if (!provider)
+        return;
+    const recommended = ConfigParser.recommendedModels()[provider];
+    if (!recommended) {
+        throw new Error(`No recommended models for "${provider}". Use a provider with recommendations: ${Object.keys(ConfigParser.recommendedModels()).join(', ')}`);
+    }
+    for (const role of MODEL_ROLES) {
+        if (ai[role])
+            continue;
+        if (!recommended[role])
+            continue;
+        ai[role] = await resolveModel(provider, role);
+    }
+    if (!ai.decisionModel && recommended.decisionModel)
+        ai.decisionModel = { provider, model: recommended.decisionModel };
+    const missing = missingModelRoles(provider);
+    if (missing.length)
+        tag('warning').log(`No recommended ${missing.join(' and ')} for ${provider} — set them explicitly as "provider/model-id"`);
+}
 export function resolveLangfuse(ai) {
     if (!ai)
         return;

package/docs/basics/getting-started.md

@@ -15,21 +15,28 @@ You need Node.js 24+ (or Bun), an AI provider key, and a modern terminal — iTe
 
 ## 2. Configure
 
-Create the config files:
+Run the setup wizard:
 
 ```bash
 npx explorbot init
 ```
 
-This writes `explorbot.config.js`, an `.env` file for your keys, and an `output/` folder.
+It asks for your AI provider, its API key, and your app's URL, then writes everything for you: `explorbot.config.js`, an `.env` file with the key stored, and an `output/` folder. No manual file editing.
 
-Open `.env` and add your provider key:
+The generated config keeps models simple — one line picks the recommended set for your provider:
 
-```bash
-OPENROUTER_API_KEY=sk-...
+```javascript
+export default {
+  web: {
+    url: 'http://localhost:3000',
+  },
+  ai: {
+    recommendedModels: 'openrouter',
+  },
+};
 ```
 
-Then open `explorbot.config.js` and set your app's base URL — the host only, no path:
+`ai.recommendedModels` fills every model role from the provider's bundled recommendations. To pin a single role instead, write it as `'provider/model-id'` — it overrides the recommendation:
 
 ```javascript
 export default {
@@ -37,10 +44,8 @@ export default {
     url: 'http://localhost:3000',
   },
   ai: {
-    model: 'openrouter/openai/gpt-oss-20b:nitro',
-    visionModel: 'openrouter/openai/gpt-5.6-luna',
-    agenticModel: 'openrouter/anthropic/claude-haiku-5.5',
-    decisionModel: { provider: 'openrouter', model: 'typesafe/jev-latest' },
+    recommendedModels: 'openrouter',
+    agenticModel: 'groq/openai/gpt-oss-120b',
   },
 };
 ```
@@ -84,6 +89,14 @@ Explorbot uses three models. Pick each one for speed and cost:
 
 Captain and Pilot barely use tokens, so a smarter `agenticModel` improves results for almost no extra cost. OpenRouter is the simplest start — one key, many models. To use OpenAI, Anthropic, Groq, or others, see [Providers](./providers.md). For every config option, see [Configuration](../reference/configuration.md).
 
+Want to see Explorbot work before pointing it at your app? Run it on the sample app:
+
+```bash
+npx explorbot explore https://todomvc.com/examples/react/dist/
+```
+
+You can also run it from the [VS Code extension](https://testomat.ai/explorbot) — pick a site, start a bot, and watch it test without leaving the editor. Full documentation lives at [testomat.ai/docs/explorbot](https://testomat.ai/docs/explorbot).
+
 ## 3. Tell Explorbot how to log in
 
 Most apps need a login. Give Explorbot the credentials once, and it signs in on its own:

package/docs/basics/providers.md

@@ -4,6 +4,8 @@ Explorbot connects to AI providers through the [Vercel AI SDK](https://sdk.verce
 
 Every provider below is set up the classical way: install its package, import it, build the client. Explorbot bundles some of these packages — for those you can skip the install and name the model as `'provider/model-id'` instead. See [Getting Started](./getting-started.md#2-configure) for that list and the two styles side by side.
 
+A third, shortest style names just the provider: `ai: { recommendedModels: 'openrouter' }` fills every unset role from that provider's bundled recommendations. An explicit role set alongside it wins, so `recommendedModels` with a pinned `agenticModel` mixes both styles.
+
 > The `export default` config block inside each `<!-- START/END provider -->` marker is generated from [`models.json`](../../models.json). After editing that file, run `bunosh docs:sync`. Everything else — including the import blocks — is hand-written.
 
 ## Requirements

package/docs/reference/commands.md

@@ -920,7 +920,9 @@ npx explorbot init --config-path ./explorbot.config.js
 npx explorbot init --force
 ```
 
-Passing `--config-path` or `--path` means local, and so does running outside a terminal (agents, CI): the chooser is skipped and the project config is written as before.
+The local wizard picks the provider, takes the API key (optionally checked with one test AI call), and asks for your app's URL — then writes everything: the key goes into `.env`, the URL into `web.url`, and the models come from `ai.recommendedModels: '<provider>'`. Nothing is left to edit by hand.
+
+Passing `--config-path` or `--path` means local, and so does running outside a terminal (agents, CI): the chooser is skipped and the project config is written with placeholder values instead. Init then prints the exact paths of the files that still need attention, a demo command to try Explorbot on a sample app (`npx explorbot explore https://todomvc.com/examples/react/dist/`), and links to the [VS Code extension](https://testomat.ai/explorbot) and the [docs](https://testomat.ai/docs/explorbot).
 
 `--global` runs the global wizard instead — pick a provider, paste the API key, optionally check it with one test AI call. The wizard writes `~/.explorbot/config.js` with the recommended model ids of this Explorbot version and stores the key in `~/.explorbot/.env`.
 
@@ -939,7 +941,8 @@ The global config holds models and keys, never a site: every command names the s
 | `-p, --path <path>` | Working directory for initialization |
 | `-g, --global` | Configure `~/.explorbot` to run from anywhere |
 | `--provider <name>` | AI provider for the global config, skips the wizard |
-| `--api-key <key>` | API key stored in `~/.explorbot/.env` |
+| `--api-key <key>` | API key stored in `~/.explorbot/.env` (local init: written to the project `.env`) |
+| `--url <url>` | Web application URL written to `web.url` in the local config |
 
 See [Configuration](configuration.md#running-from-anywhere-the-global-installation) for the directory layout and how a site is resolved.
 

package/docs/reference/configuration.md

@@ -536,6 +536,7 @@ export default {
   // AI provider settings
   ai: {
     model: groq('openai/gpt-oss-20b'),   // Default model instance (required)
+    recommendedModels: 'openrouter',     // Fills every unset role from this provider's bundled recommendations; explicit roles win
     visionModel: groq('meta-llama/llama-4-scout-17b-16e-instruct'),  // Model for screenshot analysis; setting it enables vision features
     decisionModel: { provider: 'openrouter', model: 'typesafe/jev-1.13' }, // Optional; see providers docs
     config: {},                    // Additional provider config

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "explorbot",
-  "version": "0.5.7",
+  "version": "0.5.8",
   "description": "CLI app built with React Ink, CodeceptJS, and Playwright",
   "license": "Elastic-2.0",
   "type": "module",

package/src/commands/explore-command.ts

@@ -583,6 +583,14 @@ export class ExploreCommand extends BaseCommand {
       });
     }
 
+    sections.push({
+      label: 'Explore more',
+      commands: [
+        { label: 'Whole site', command: `${cli} explore /` },
+        { label: 'Docs', command: 'https://testomat.ai/docs/explorbot' },
+      ],
+    });
+
     printNextSteps(sections);
   }
 

package/src/commands/init-command.ts

@@ -1,25 +1,30 @@
 import { existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { dirname, extname, join, resolve } from 'node:path';
 import chalk from 'chalk';
+import figureSet from 'figures';
 import { ConfigParser, type ModelRole, PROVIDERS, missingModelRoles } from '../config.ts';
 import { findGlobalConfig, globalConfigPath, globalDir, globalEnvPath } from '../global-config.ts';
 import { getCliName } from '../utils/cli-name.ts';
 import { log, tag } from '../utils/logger.js';
-import { relativeToCwd } from '../utils/next-steps.ts';
+import { type NextStepCommand, type NextStepSection, printNextSteps, relativeToCwd } from '../utils/next-steps.ts';
 
-function defaultConfigTemplate(provider: string): string {
+function defaultConfigTemplate(provider: string, url?: string): string {
+  const appUrl = url || 'http://<your-app-host-here>';
   return `// 'provider/model-id' uses a bundled provider.
 // It is also possible to import provider as a module from Vercel AI SDK.
-// https://github.com/testomatio/explorbot/blob/main/docs/basics/providers.md
+// https://testomat.ai/docs/explorbot
 
 const config = {
   web: {
     // use application host without path prefix (e.g., http://localhost:3000)
-    url: 'http://<your-app-host-here>',
+    url: '${appUrl}',
   },
 
   ai: {
-${modelLines(provider)}
+    // every role (model, visionModel, agenticModel) takes the recommended ${provider} models bundled with this version
+    // override a single role as 'provider/model-id':
+    // model: '${provider}/<model-id>',
+    recommendedModels: '${provider}',
   },
 
   reporter: {
@@ -37,8 +42,9 @@ export default config;
 }
 
 export function envTemplate(provider: string): string {
+  const { keyUrl } = PROVIDERS[provider];
   const keyLines = Object.entries(PROVIDERS).map(([name, { envKey }]) => {
-    if (name === provider) return `${envKey}=`;
+    if (name === provider) return `# Create a key at ${keyUrl} and paste it after '='\n${envKey}=`;
     return `# ${envKey}=`;
   });
 
@@ -69,10 +75,10 @@ export async function runInit(options: InitCommandOptions): Promise<void> {
   const choice = await renderInitWizard('choose');
   if (choice !== 'local') return;
 
-  const provider = await renderLocalProviderWizard();
-  if (!provider) return;
+  const setup = await renderLocalSetupWizard();
+  if (!setup) return;
 
-  runInitCommand({ ...options, provider });
+  runInitCommand({ ...options, ...setup });
 }
 
 export function writeGlobalConfig(provider: string, apiKey?: string): void {
@@ -82,24 +88,28 @@ export function writeGlobalConfig(provider: string, apiKey?: string): void {
 
   mkdirSync(globalDir(), { recursive: true });
   writeFileSync(globalConfigPath(), globalConfigTemplate(provider), 'utf8');
-  log(`Created global config: ${globalConfigPath()}`);
+  tag('success').log(`${figureSet.tick} Created global config: ${globalConfigPath()}`);
 
   const envKey = PROVIDERS[provider].envKey;
   writeEnvKey(envKey, apiKey || '');
-  log(`Stored ${envKey} in ${globalEnvPath()}`);
+  tag('success').log(`${figureSet.tick} Stored ${envKey} in ${globalEnvPath()}`);
 
   const missing = missingModelRoles(provider);
   if (missing.length) {
     tag('warning').log(`No recommended ${missing.join(' and ')} for ${provider} — set the model ids in ${globalConfigPath()}`);
   }
   if (!apiKey && !process.env[envKey]) {
-    tag('warning').log(`Add your API key to ${globalEnvPath()}`);
+    printApiKeySteps(provider, globalEnvPath());
   }
 
   log('');
-  log('Explorbot now runs from any directory:');
-  tag('substep').log(chalk.yellow(`${getCliName()} explore https://your-app.example.com`));
-  tag('substep').log(chalk.yellow(`${getCliName()} sites`));
+  log(`${figureSet.star} What's next:`);
+  printInitNextSteps({
+    siteCommands: [
+      { label: 'Any site', command: `${getCliName()} explore https://your-app.example.com` },
+      { label: 'Saved sites', command: `${getCliName()} sites` },
+    ],
+  });
 }
 
 export function runInitCommand(options: InitCommandOptions): void {
@@ -141,38 +151,42 @@ export function runInitCommand(options: InitCommandOptions): void {
       process.exit(1);
     }
 
-    writeFileSync(outPath, defaultConfigTemplate(provider), 'utf8');
-    log(`Created config file: ${relativeToCwd(outPath)}`);
+    writeFileSync(outPath, defaultConfigTemplate(provider, options.url), 'utf8');
+    tag('success').log(`${figureSet.tick} Created config file: ${relativeToCwd(outPath)}`);
 
     const envPath = resolve(process.cwd(), '.env');
     if (!existsSync(envPath)) {
       writeFileSync(envPath, `${envTemplate(provider)}\n`, 'utf8');
-      log(`Created env file: ${relativeToCwd(envPath)}`);
+      tag('success').log(`${figureSet.tick} Created env file: ${relativeToCwd(envPath)}`);
     } else {
       log(`Env file already exists: ${relativeToCwd(envPath)}`);
     }
 
+    const envKey = PROVIDERS[provider].envKey;
+    if (options.apiKey) {
+      writeEnvKey(envKey, options.apiKey, envPath);
+      tag('success').log(`${figureSet.tick} Stored ${envKey} in ${relativeToCwd(envPath)}`);
+    }
+    if (!options.apiKey && !process.env[envKey]) {
+      printApiKeySteps(provider, relativeToCwd(envPath));
+    }
+    if (!options.url) {
+      tag('warning').log(`Set your application URL in web.url: ${relativeToCwd(outPath)}`);
+    }
+
     const missing = missingModelRoles(provider);
     if (missing.length) {
       tag('warning').log(`No recommended ${missing.join(' and ')} for ${provider} — set the model ids in ${relativeToCwd(outPath)}`);
     }
 
-    log('');
-    log('Next steps:');
-    log('1. Configure AI provider in .env');
-    log('2. Set AI models config file');
-    log('3. Set web application URL in the config file');
-    log('4. Add initial knowledge (how to authorize to the application, etc.)');
-    tag('substep').log(chalk.yellow(`${getCliName()} learn '*' 'to authorize use these credentials: admin@example.com / secret123'`));
-    tag('substep').log('You can use ${env.LOGIN} and ${env.PASSWORD} to reference environment variables.');
-
-    log('5. Launch application on a relative URL');
-    tag('substep').log(chalk.yellow(`${getCliName()} start /dashboard`));
-
     if (!existsSync('./output')) {
       mkdirSync('./output', { recursive: true });
-      log('Created directory: output');
+      tag('success').log(`${figureSet.tick} Created directory: output`);
     }
+
+    log('');
+    log(`${figureSet.star} What's next:`);
+    printInitNextSteps({ url: options.url });
   } catch (error) {
     log('Failed to create config file:', error);
     process.exit(1);
@@ -227,13 +241,13 @@ async function renderInitWizard(mode: 'choose' | 'global'): Promise<'local' | 'g
   });
 }
 
-async function renderLocalProviderWizard(): Promise<string | null> {
+async function renderLocalSetupWizard(): Promise<LocalSetup | null> {
   const [{ render }, React, InitWizard] = await Promise.all([import('ink'), import('react'), import('../components/InitWizard.js').then((m) => m.default)]);
 
   return new Promise((resolve) => {
-    const finish = (provider: string | null) => {
+    const finish = (setup: LocalSetup | null) => {
       unmount();
-      resolve(provider);
+      resolve(setup);
     };
     const { unmount } = render(
       React.createElement(InitWizard, {
@@ -242,7 +256,7 @@ async function renderLocalProviderWizard(): Promise<string | null> {
         onLocal: () => finish(null),
         onComplete: () => finish(null),
         onCancel: () => finish(null),
-        onLocalProvider: (provider: string) => finish(provider),
+        onLocalSetup: (setup) => finish(setup),
       }),
       { exitOnCtrlC: false, patchConsole: false }
     );
@@ -274,7 +288,7 @@ function globalConfigTemplate(provider: string): string {
 // Models are written as 'provider/model-id' so they resolve without a local node_modules.
 // The key is read from ${envKey} in ~/.explorbot/.env
 // Model ids are snapshotted from the recommendations of this Explorbot version.
-// https://github.com/testomatio/explorbot/blob/main/docs/basics/providers.md
+// https://testomat.ai/docs/explorbot
 const config = {
   ai: {
 ${modelLines(provider)}
@@ -292,8 +306,47 @@ export default config;
 `;
 }
 
-function writeEnvKey(key: string, value: string): void {
-  const envPath = globalEnvPath();
+function printInitNextSteps(options: { url?: string; siteCommands?: NextStepCommand[] }): void {
+  const cli = getCliName();
+  const sections: NextStepSection[] = [
+    {
+      label: 'Try the demo on a sample app',
+      commands: [{ command: `${cli} explore https://todomvc.com/examples/react/dist/` }],
+    },
+  ];
+
+  if (options.url) {
+    sections.push({
+      label: 'Explore your app',
+      commands: [
+        { label: 'Whole site', command: `${cli} explore ${options.url}` },
+        { label: 'One page', command: `${cli} explore /dashboard` },
+      ],
+    });
+  }
+
+  if (options.siteCommands) sections.push({ label: 'Explore any site', commands: options.siteCommands });
+
+  sections.push(
+    {
+      label: 'Run it from VS Code',
+      commands: [{ command: 'https://testomat.ai/explorbot' }],
+    },
+    {
+      label: 'Docs',
+      commands: [{ command: 'https://testomat.ai/docs/explorbot' }],
+    }
+  );
+
+  printNextSteps(sections);
+
+  log('');
+  log('Add knowledge (logins, credentials) — created on first use in ./knowledge:');
+  tag('substep').log(chalk.yellow(`${cli} learn '*' 'to authorize use these credentials: admin@example.com / secret123'`));
+  tag('substep').log('You can use ${env.LOGIN} and ${env.PASSWORD} to reference environment variables.');
+}
+
+function writeEnvKey(key: string, value: string, envPath = globalEnvPath()): void {
   let content = '# AI provider API keys';
   if (existsSync(envPath)) content = readFileSync(envPath, 'utf8').trimEnd();
 
@@ -306,6 +359,19 @@ function writeEnvKey(key: string, value: string): void {
   writeFileSync(envPath, `${lines.join('\n').trimEnd()}\n`, 'utf8');
 }
 
+function printApiKeySteps(provider: string, envPath: string): void {
+  const { envKey, keyUrl } = PROVIDERS[provider];
+  tag('warning').log(`No API key yet — explorbot needs one to connect to ${provider}`);
+  tag('substep').log(`1. Create a key at ${keyUrl}`);
+  tag('substep').log(`2. Paste it into ${envPath}: ${envKey}=<your-key>`);
+}
+
+type LocalSetup = {
+  provider: string;
+  apiKey: string;
+  url: string;
+};
+
 type InitCommandOptions = {
   configPath?: string;
   force?: boolean;
@@ -313,4 +379,5 @@ type InitCommandOptions = {
   global?: boolean;
   provider?: string;
   apiKey?: string;
+  url?: string;
 };

package/src/components/InitWizard.tsx

@@ -15,14 +15,16 @@ interface InitWizardProps {
   onLocal: () => void;
   onComplete: () => void;
   onCancel: () => void;
-  onLocalProvider?: (provider: string) => void;
+  onLocalSetup?: (setup: { provider: string; apiKey: string; url: string }) => void;
 }
 
-const InitWizard: React.FC<InitWizardProps> = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, onLocalProvider }) => {
-  const [step, setStep] = useState<'target' | 'provider' | 'key' | 'validate'>(mode === 'choose' ? 'target' : 'provider');
+const InitWizard: React.FC<InitWizardProps> = ({ mode, globalConfigExists, onLocal, onComplete, onCancel, onLocalSetup }) => {
+  const [step, setStep] = useState<'target' | 'provider' | 'key' | 'validate' | 'url'>(mode === 'choose' ? 'target' : 'provider');
   const [targetIndex, setTargetIndex] = useState(0);
   const [providerIndex, setProviderIndex] = useState(0);
   const [apiKey, setApiKey] = useState('');
+  const [url, setUrl] = useState('');
+  const [urlError, setUrlError] = useState('');
   const [status, setStatus] = useState('');
   const [error, setError] = useState('');
 
@@ -30,6 +32,11 @@ const InitWizard: React.FC<InitWizardProps> = ({ mode, globalConfigExists, onLoc
   const envKey = PROVIDERS[provider].envKey;
 
   const save = () => {
+    if (mode === 'local') {
+      setStatus('');
+      setStep('url');
+      return;
+    }
     writeGlobalConfig(provider, apiKey.trim());
     onComplete();
   };
@@ -61,7 +68,7 @@ const InitWizard: React.FC<InitWizardProps> = ({ mode, globalConfigExists, onLoc
       return;
     }
 
-    if (step === 'key') return;
+    if (step === 'key' || step === 'url') return;
 
     if (key.escape) {
       onCancel();
@@ -79,10 +86,7 @@ const InitWizard: React.FC<InitWizardProps> = ({ mode, globalConfigExists, onLoc
     if (step === 'provider') {
       if (key.upArrow) setProviderIndex((index) => Math.max(0, index - 1));
       if (key.downArrow) setProviderIndex((index) => Math.min(PROVIDER_NAMES.length - 1, index + 1));
-      if (key.return) {
-        if (mode === 'local') onLocalProvider?.(provider);
-        else setStep('key');
-      }
+      if (key.return) setStep('key');
       return;
     }
 
@@ -132,7 +136,10 @@ const InitWizard: React.FC<InitWizardProps> = ({ mode, globalConfigExists, onLoc
       {step === 'key' && (
         <Box flexDirection="column">
           <Text>
-            Enter the API key for {provider} <Text dimColor>(stored as {envKey})</Text>
+            Enter the API key for {provider}{' '}
+            <Text dimColor>
+              (stored as {envKey}, create one at {PROVIDERS[provider].keyUrl})
+            </Text>
           </Text>
           <Box borderStyle="single" borderColor="blue" paddingX={1}>
             <InputReadline value={apiKey} onChange={setApiKey} onSubmit={() => setStep('validate')} placeholder={process.env[envKey] ? 'leave empty to keep the key from your environment' : 'paste the key'} isActive showPrompt={false} mask />
@@ -147,15 +154,40 @@ const InitWizard: React.FC<InitWizardProps> = ({ mode, globalConfigExists, onLoc
           {error && (
             <Box flexDirection="column">
               <Text color="red">{error}</Text>
-              <Text dimColor>r: re-enter the key | n: save anyway</Text>
+              <Text dimColor>r: re-enter the key | n: continue anyway</Text>
             </Box>
           )}
         </Box>
       )}
 
+      {step === 'url' && (
+        <Box flexDirection="column">
+          <Text>
+            What is the URL of the web application to test? <Text dimColor>(written to web.url in the config)</Text>
+          </Text>
+          <Box borderStyle="single" borderColor="blue" paddingX={1}>
+            <InputReadline
+              value={url}
+              onChange={setUrl}
+              onSubmit={() => {
+                if (!URL.canParse(url.trim())) {
+                  setUrlError('Enter a full URL, e.g. http://localhost:3000');
+                  return;
+                }
+                onLocalSetup?.({ provider, apiKey: apiKey.trim(), url: url.trim() });
+              }}
+              placeholder="http://localhost:3000"
+              isActive
+              showPrompt={false}
+            />
+          </Box>
+          {urlError && <Text color="red">{urlError}</Text>}
+        </Box>
+      )}
+
       <Box marginTop={1}>
         <Text dimColor>
-          Config goes to {mode === 'local' ? 'the current directory' : globalDir()} | {step === 'key' ? 'Enter: continue' : '↑↓: select | Enter: confirm'} | Ctrl+C: exit
+          Config goes to {mode === 'local' ? 'the current directory' : globalDir()} | {step === 'key' || step === 'url' ? 'Enter: continue' : '↑↓: select | Enter: confirm'} | Ctrl+C: exit
         </Text>
       </Box>
     </Box>

package/src/config.ts

@@ -11,13 +11,13 @@ import { deepMerge } from './utils/merge.js';
 import { log, tag } from './utils/logger.js';
 
 export const PROVIDERS: Record<string, ProviderInfo> = {
-  openai: { envKey: 'OPENAI_API_KEY', load: async () => (await import('@ai-sdk/openai')).createOpenAI() },
-  anthropic: { envKey: 'ANTHROPIC_API_KEY', load: async () => (await import('@ai-sdk/anthropic')).createAnthropic() },
-  google: { envKey: 'GOOGLE_GENERATIVE_AI_API_KEY', load: async () => (await import('@ai-sdk/google')).createGoogleGenerativeAI() },
-  groq: { envKey: 'GROQ_API_KEY', load: async () => (await import('@ai-sdk/groq')).createGroq() },
-  mistral: { envKey: 'MISTRAL_API_KEY', load: async () => (await import('@ai-sdk/mistral')).createMistral() },
-  openrouter: { envKey: 'OPENROUTER_API_KEY', load: async () => (await import('@openrouter/ai-sdk-provider')).createOpenRouter() },
-  sambanova: { envKey: 'SAMBANOVA_API_KEY', load: async () => (await import('sambanova-ai-provider')).createSambaNova() },
+  openai: { envKey: 'OPENAI_API_KEY', keyUrl: 'https://platform.openai.com/api-keys', load: async () => (await import('@ai-sdk/openai')).createOpenAI() },
+  anthropic: { envKey: 'ANTHROPIC_API_KEY', keyUrl: 'https://console.anthropic.com/settings/keys', load: async () => (await import('@ai-sdk/anthropic')).createAnthropic() },
+  google: { envKey: 'GOOGLE_GENERATIVE_AI_API_KEY', keyUrl: 'https://aistudio.google.com/apikey', load: async () => (await import('@ai-sdk/google')).createGoogleGenerativeAI() },
+  groq: { envKey: 'GROQ_API_KEY', keyUrl: 'https://console.groq.com/keys', load: async () => (await import('@ai-sdk/groq')).createGroq() },
+  mistral: { envKey: 'MISTRAL_API_KEY', keyUrl: 'https://console.mistral.ai/api-keys', load: async () => (await import('@ai-sdk/mistral')).createMistral() },
+  openrouter: { envKey: 'OPENROUTER_API_KEY', keyUrl: 'https://openrouter.ai/keys', load: async () => (await import('@openrouter/ai-sdk-provider')).createOpenRouter() },
+  sambanova: { envKey: 'SAMBANOVA_API_KEY', keyUrl: 'https://cloud.sambanova.ai/apis', load: async () => (await import('sambanova-ai-provider')).createSambaNova() },
 };
 
 export const MODEL_ROLES: ModelRole[] = ['model', 'visionModel', 'agenticModel'];
@@ -169,6 +169,7 @@ interface AgentsConfig {
 
 interface AIConfig {
   model: any;
+  recommendedModels?: string;
   apiKey?: string;
   config?: Record<string, any>;
   langfuse?: {
@@ -890,11 +891,34 @@ export async function resolveConfigModels(ai?: AIConfig): Promise<void> {
     if (typeof ai[role] === 'string') ai[role] = await resolveModel(ai[role], role);
   }
 
+  await fillRecommendedModels(ai);
+
   for (const agent of Object.values(ai.agents || {})) {
     if (typeof agent?.model === 'string') agent.model = await resolveModel(agent.model);
   }
 }
 
+async function fillRecommendedModels(ai: AIConfig): Promise<void> {
+  const provider = ai.recommendedModels;
+  if (!provider) return;
+
+  const recommended = ConfigParser.recommendedModels()[provider];
+  if (!recommended) {
+    throw new Error(`No recommended models for "${provider}". Use a provider with recommendations: ${Object.keys(ConfigParser.recommendedModels()).join(', ')}`);
+  }
+
+  for (const role of MODEL_ROLES) {
+    if (ai[role]) continue;
+    if (!recommended[role]) continue;
+    ai[role] = await resolveModel(provider, role);
+  }
+
+  if (!ai.decisionModel && recommended.decisionModel) ai.decisionModel = { provider, model: recommended.decisionModel };
+
+  const missing = missingModelRoles(provider);
+  if (missing.length) tag('warning').log(`No recommended ${missing.join(' and ')} for ${provider} — set them explicitly as "provider/model-id"`);
+}
+
 export function resolveLangfuse(ai?: AIConfig): void {
   if (!ai) return;
 
@@ -994,6 +1018,7 @@ interface ConfiguredModel {
 
 interface ProviderInfo {
   envKey: string;
+  keyUrl: string;
   load: () => Promise<(modelId: string) => any>;
 }